Enhanced Sequential Thinking MCP Server
Custom Enhanced Version by new69toss
A Model Context Protocol (MCP) server that facilitates structured, progressive thinking through defined stages with enhanced capabilities for the AI Prompt Optimizer project. This tool helps break down complex problems into sequential thoughts, track the progression of your thinking process, and generate summaries.
Features
Structured Thinking Framework: Organizes thoughts through standard cognitive stages (Problem Definition, Research, Analysis, Synthesis, Conclusion)
Thought Tracking: Records and manages sequential thoughts with metadata
Related Thought Analysis: Identifies connections between similar thoughts
Progress Monitoring: Tracks your position in the overall thinking sequence
Summary Generation: Creates concise overviews of the entire thought process
Persistent Storage: Automatically saves your thinking sessions with thread-safety
Data Import/Export: Share and reuse thinking sessions
Extensible Architecture: Easily customize and extend functionality
Robust Error Handling: Graceful handling of edge cases and corrupted data
Type Safety: Comprehensive type annotations and validation
Prerequisites
Python 3.10 or higher
UV package manager (Install Guide)
Key Technologies
Pydantic: For data validation and serialization
Portalocker: For thread-safe file access
FastMCP: For Model Context Protocol integration
Rich: For enhanced console output
PyYAML: For configuration management
Project Structure
Quick Start
Set Up Project
# Create and activate virtual environment uv venv .venv\Scripts\activate # Windows source .venv/bin/activate # Unix # Install package and dependencies uv pip install -e . # For development with testing tools uv pip install -e ".[dev]" # For all optional dependencies uv pip install -e ".[all]"Run the Server
# Run directly uv run -m mcp_sequential_thinking.server # Or use the installed script mcp-sequential-thinkingRun Tests
# Run all tests pytest # Run with coverage report pytest --cov=mcp_sequential_thinking
Claude Desktop Integration
Add to your Claude Desktop configuration (%APPDATA%\Claude\claude_desktop_config.json
on Windows):
Alternatively, if you've installed the package with pip install -e .
, you can use:
You can also run it directly using uvx and skipping the installation step:
How It Works
The server maintains a history of thoughts and processes them through a structured workflow. Each thought is validated using Pydantic models, categorized into thinking stages, and stored with relevant metadata in a thread-safe storage system. The server automatically handles data persistence, backup creation, and provides tools for analyzing relationships between thoughts.
Usage Guide
The Sequential Thinking server exposes three main tools:
1. process_thought
Records and analyzes a new thought in your sequential thinking process.
Parameters:
thought
(string): The content of your thoughtthought_number
(integer): Position in your sequence (e.g., 1 for first thought)total_thoughts
(integer): Expected total thoughts in the sequencenext_thought_needed
(boolean): Whether more thoughts are needed after this onestage
(string): The thinking stage - must be one of:"Problem Definition"
"Research"
"Analysis"
"Synthesis"
"Conclusion"
tags
(list of strings, optional): Keywords or categories for your thoughtaxioms_used
(list of strings, optional): Principles or axioms applied in your thoughtassumptions_challenged
(list of strings, optional): Assumptions your thought questions or challenges
Example:
2. generate_summary
Generates a summary of your entire thinking process.
Example output:
3. clear_history
Resets the thinking process by clearing all recorded thoughts.
Practical Applications
Decision Making: Work through important decisions methodically
Problem Solving: Break complex problems into manageable components
Research Planning: Structure your research approach with clear stages
Writing Organization: Develop ideas progressively before writing
Project Analysis: Evaluate projects through defined analytical stages
Getting Started
With the proper MCP setup, simply use the process_thought
tool to begin working through your thoughts in sequence. As you progress, you can get an overview with generate_summary
and reset when needed with clear_history
.
Customizing the Sequential Thinking Server
For detailed examples of how to customize and extend the Sequential Thinking server, see example.md. It includes code samples for:
Modifying thinking stages
Enhancing thought data structures with Pydantic
Adding persistence with databases
Implementing enhanced analysis with NLP
Creating custom prompts
Setting up advanced configurations
Building web UI integrations
Implementing visualization tools
Connecting to external services
Creating collaborative environments
Separating test code
Building reusable utilities
License
MIT License
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables structured problem-solving through sequential thinking stages with persistent storage and analysis. Helps break down complex problems into manageable cognitive steps while tracking progress and generating summaries of the entire thought process.