sequential-thinking-mcp

The Sequential Thinking MCP Server enables advanced meta-cognition and dynamic problem-solving through structured thought logging and workflow orchestration:

Dynamic Problem-Solving: Logs AI's internal thoughts and reasoning to guide through complex tasks
Agentic Workflow Orchestration: Breaks tasks into precise, manageable, and traceable steps
Iterative Refinement: Self-corrects and adapts based on step outcomes or new information
Proactive Planning: Manages future tasks using left_to_be_done fields
Tool Recommendations: Suggests specific tools for executing planned actions
Automatic Smart Thinking: Minimizes user input by proactively determining next steps
Thread Management: Organizes thoughts into structured problem-solving threads
Thought Tracking: Uses thought_index to chronologically track and revise reasoning

Sequential Thinking MCP

This repository provides an MCP (Model Context Protocol) server that enables an AI agent to perform advanced meta-cognition and dynamic, reflective problem-solving.

This version of Sequential Thinking is quite different than the original one, as it only forces the agent to virtually log its thoughts and plans, without actually doing anything, except prompting itself. I found it to be sufficient enough for any kind of LLMs.

Features

Advanced Meta-Cognition: Provides a think tool for dynamic and reflective problem-solving through thought logging.
Agentic Workflow Orchestration: Guides AI agents through complex tasks by breaking them into precise, manageable, and traceable steps.
Iterative Refinement: Assesses the success of each step and self-corrects if necessary, adapting to new information or errors.
Proactive Planning: Utilizes left_to_be_done for explicit future state management and task estimation.
Tool Recommendation: Suggests specific tools via tool_recommendation to execute planned actions or gather necessary information.

Setup

Prerequisites

Python 3.10+
uv (for local development)

Installation

Choose one of the following installation methods.

Install from PyPI (Recommended)

This method is best for using the package as a library or running the server without modifying the code.

Install the package from PyPI:

pip install sequential-thinking-mcp

Run the MCP server (default: stdio):

python -m sequential_thinking

For Local Development

This method is for contributors who want to modify the source code. Using uv:

Clone the repository:

git clone https://github.com/philogicae/sequential-thinking-mcp.git
cd sequential-thinking-mcp

Install dependencies using uv:

uv sync --locked

Run the MCP server (default: stdio):

uv run -m sequential_thinking

For Docker

Clone the repository (if you haven't already):

git clone https://github.com/philogicae/sequential-thinking-mcp.git
cd sequential-thinking-mcp

Build and run the container using Docker Compose (default port: 8000):

docker compose up --build -d

Access container logs:

docker logs sequential-thinking-mcp -f

Usage

As MCP Server

from sequential_thinking import mcp

mcp.run(transport="sse")

Via MCP Clients

Usable with any MCP-compatible client. Available tools:

think: Log a thought, plan next steps, and recommend tools.

Example with Windsurf

Configuration:

{
  "mcpServers": {
    ...
    # with stdio (only requires uv)
    "sequential-thinking-mcp": {
      "command": "uvx",
      "args": [ "sequential-thinking-mcp" ]
    },
    # with sse transport (requires installation)
    "sequential-thinking-mcp": {
      "serverUrl": "http://127.0.0.1:8000/sse"
    },
    # with streamable-http transport (requires installation)
    "sequential-thinking-mcp": {
      "serverUrl": "http://127.0.0.1:8000/mcp" # not yet supported by every client
    },
    ...
  }
}

Changelog

See CHANGELOG.md for a history of changes to this project.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

sequential-thinking-mcp