sequential-thinking-mcp

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.

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 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:

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

Run the MCP server:

uv run -m sequential_thinking

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