Submit
MattMagg

sequential-thinking-claude-code

Community MattMagg
Updated

🧠 Enhanced MCP Sequential Thinking Server with 26 pre-integrated tools including Claude Code and Basic Memory MCP. Features enhanced thinking dynamics for full utilization on revisiting and branching and automatic tool recommendations based on thought content.

sequential-thinking-claude-code

An enhanced version of the original mcp-sequentialthinking-tools by Scott Spence, which was adapted from the MCP Sequential Thinking Server.

This enhanced edition transforms the original framework into an intelligent tool recommendation system with:

  • 26 pre-configured tools including all Claude Code tools
  • Automatic tool recommendations based on thought content
  • Deep integration with Basic Memory MCP for knowledge management
  • Pattern-based intelligence that suggests the right tools at the right time

Credits: Original repository by Scott Spence. Basic Memory tools from Basic Machines Co. Enhanced with permission.

A Model Context Protocol (MCP) server that combines sequentialthinking with tool usage suggestions. For each step in theproblem-solving process, it provides confidence scores and rationalefor tools that could be used, based on tools available in your environment.

What's New in This Enhanced Edition

🚀 Key Improvements

  • Auto-recommends tools based on your thought content (no manual specification needed!)
  • 26 pre-integrated tools ready to use out of the box
  • Intelligent pattern matching that understands context
  • Basic Memory integration for persistent knowledge management

📦 Included Tool Sets

Claude Code Tools (17 tools)
  • File operations: Read, Write, Edit, MultiEdit, LS, Glob, Grep
  • Execution: Bash, Agent
  • Notebooks: NotebookRead, NotebookEdit
  • Web: WebFetch, WebSearch
  • Tasks: TodoRead, TodoWrite
  • Special: StickerRequest
Basic Memory Tools (9 tools)
  • mcp__basic-memory__write_note - Record knowledge
  • mcp__basic-memory__read_note - Access saved information
  • mcp__basic-memory__search_notes - Search your knowledge base
  • mcp__basic-memory__build_context - Follow knowledge connections
  • And more...

Original Features (Enhanced)

  • 🤔 Dynamic and reflective problem-solving through sequential thoughts
  • 🔄 Flexible thinking process that adapts and evolves
  • 🌳 Support for branching and revision of thoughts
  • 🛠️ NEW: Automatic tool suggestions based on thought content
  • 📊 ENHANCED: Pre-configured confidence scores for each tool
  • 🔍 ENHANCED: Context-aware rationale generation
  • 📝 Step tracking with expected outcomes
  • 🔄 Progress monitoring with previous and remaining steps
  • 🎯 ENHANCED: Intelligent alternative tool suggestions

How It Works

Original Behavior

The original server provided a framework for tool recommendations but required manual tool specification.

Enhanced Behavior

This version automatically analyzes your thoughts and recommends appropriate tools:

// You think: "I need to save this important decision"
// Server automatically recommends: mcp__basic-memory__write_note (0.95 confidence)

// You think: "Search for all TODO comments" 
// Server automatically recommends: Grep (0.85), Agent (0.75)

// You think: "I want some Claude stickers!"
// Server automatically recommends: StickerRequest (0.95)

Each recommendation includes:

  • Confidence score (0-1) based on pattern matching
  • Clear rationale explaining why the tool fits
  • Priority level for execution order
  • Alternative tools that could also work

The enhanced pattern matching understands context like:

  • "record", "save", "document" → Basic Memory write_note
  • "read", "examine", "check" → Read tool
  • "multiple edits" → MultiEdit tool
  • "run", "execute" → Bash tool

Example Usage

Here's an example of how the server guides tool usage:

{
	"thought": "Initial research step to understand what universal reactivity means in Svelte 5",
	"current_step": {
		"step_description": "Gather initial information about Svelte 5's universal reactivity",
		"expected_outcome": "Clear understanding of universal reactivity concept",
		"recommended_tools": [
			{
				"tool_name": "search_docs",
				"confidence": 0.9,
				"rationale": "Search Svelte documentation for official information",
				"priority": 1
			},
			{
				"tool_name": "tavily_search",
				"confidence": 0.8,
				"rationale": "Get additional context from reliable sources",
				"priority": 2
			}
		],
		"next_step_conditions": [
			"Verify information accuracy",
			"Look for implementation details"
		]
	},
	"thought_number": 1,
	"total_thoughts": 5,
	"next_thought_needed": true
}

The server tracks your progress and supports:

  • Creating branches to explore different approaches
  • Revising previous thoughts with new information
  • Maintaining context across multiple steps
  • Suggesting next steps based on current findings

Configuration

This server requires configuration through your MCP client. Here areexamples for different environments:

Cline Configuration

Add this to your Cline MCP settings:

{
	"mcpServers": {
		"mcp-sequentialthinking-tools": {
			"command": "npx",
			"args": ["-y", "mcp-sequentialthinking-tools"]
		}
	}
}

Claude Desktop with WSL Configuration

For WSL environments, add this to your Claude Desktop configuration:

{
	"mcpServers": {
		"mcp-sequentialthinking-tools": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-sequentialthinking-tools"
			]
		}
	}
}

API

The server implements a single MCP tool with configurable parameters:

sequentialthinking_tools

A tool for dynamic and reflective problem-solving through thoughts,with intelligent tool recommendations.

Parameters:

  • thought (string, required): Your current thinking step
  • next_thought_needed (boolean, required): Whether another thoughtstep is needed
  • thought_number (integer, required): Current thought number
  • total_thoughts (integer, required): Estimated total thoughtsneeded
  • is_revision (boolean, optional): Whether this revises previousthinking
  • revises_thought (integer, optional): Which thought is beingreconsidered
  • branch_from_thought (integer, optional): Branching point thoughtnumber
  • branch_id (string, optional): Branch identifier
  • needs_more_thoughts (boolean, optional): If more thoughts areneeded
  • current_step (object, optional): Current step recommendation with:
    • step_description: What needs to be done
    • recommended_tools: Array of tool recommendations with confidencescores
    • expected_outcome: What to expect from this step
    • next_step_conditions: Conditions for next step
  • previous_steps (array, optional): Steps already recommended
  • remaining_steps (array, optional): High-level descriptions ofupcoming steps

Development

Setup

  1. Clone the repository
  2. Install dependencies:
pnpm install
  1. Build the project:
pnpm build
  1. Run in development mode:
pnpm dev

Publishing

The project uses changesets for version management. To publish:

  1. Create a changeset:
pnpm changeset
  1. Version the package:
pnpm changeset version
  1. Publish to npm:
pnpm release

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

Acknowledgments

MCP Server · Populars

MCP Server · New