Think

You can run the MCP Think Tool server to give your Claude-based workflows a dedicated space for structured thinking, keeping thought history and analytics while solving complex problems. This tool helps improve reasoning across long sequences of tool calls by providing a clean, traceable thinking process.

How to use

Use the Think Tool server with your MCP client to enable a structured thinking space for complex problem-solving. Start the server locally or via Docker, then point your MCP client to the configured stdio input/output or to the appropriate runtime on your host. You will gain a dedicated place to break down problems, a thought history log, and metadata about thinking patterns. Your client can start thinking steps before taking actions, review past thoughts, and clear the history when you begin a new problem.

How to install

Prerequisites: you need Python with pip to install the Think Tool package, or you can run it inside a container with Docker.

pip install mcp-think-tool

Windsurf configuration: connect the Think Tool as a local stdio server. Include the following in your MCP config under the think key.

"think": {
  "command": "/home/xxx/.local/bin/mcp-think-tool",
  "args": [],
  "type": "stdio",
  "pollingInterval": 30000,
  "startupTimeout": 30000,
  "restartOnFailure": true
}

Additional configuration options

Docker configuration is also supported. Build and run the container, then configure MCP to use the stdio interface backed by Docker.

docker build -t mcp-think-tool .

"think": {
  "command": "docker",
  "args": ["run", "--rm", "-i", "mcp-think-tool"]
}

Notes on usage

The Think Tool offers a structured thinking space, a thought history with timestamps, and metadata about thinking patterns. You can clear the thought history when starting fresh using the Clean Slate option in your tooling interface, ensuring you can begin new problem-solving sessions without prior context.

Configuration and security

If you run the server locally via Windsurf, ensure the path in command points to where the package is installed. When using Docker, ensure the container image is built from the provided Dockerfile and that you manage access to the container and its inputs securely.

Available tools

Structured Thinking Space

Provides a dedicated area for breaking down complex problems step by step, enabling clearer reasoning and plan formulation.

Thought History

Keeps a log of all thoughts with timestamps for reference during problem-solving.

Statistics and Analysis

Offers metadata about thinking patterns to help you review and improve reasoning approaches.

Clean Slate Option

Allows you to clear thought history to start fresh without prior context.