Skip to main content

MCP Think

A Model Context Protocol (MCP) server implementing the "think" tool for improving Claude's and other LLMs' complex reasoning capabilities.

Overview

This MCP server implements the "think" tool as described in Anthropic's blog post, which provides Claude with a dedicated space for structured thinking during complex problem-solving tasks. The think tool has been shown to significantly improve performance in complex tasks requiring policy adherence and reasoning in long chains of tool calls.

Features

  • Structured Thinking Space: Provides LLMs with a dedicated place to break down complex problems
  • Thought History: Maintains a log of all thoughts with timestamps for reference
  • Multiple Transport Support: Works with both stdio and SSE transports

Installation

Install from PyPI:

pip install mcp-think

Or install from source:

git clone https://github.com/ddkang1/mcp-think.git
cd mcp-think
pip install -e .

Usage

You can run the MCP server directly:

mcp-think

By default, it uses SSE transport. To use stdio transport:

mcp-think --transport stdio

You can also specify host and port for SSE transport:

mcp-think --host 0.0.0.0 --port 3001

Configuration

To use this tool with Claude in Windsurf, add the following configuration to your MCP config file:

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

For SSE transport (default):

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

The command field should point to the directory where you installed the python package using pip.

Available Tools

The MCP server provides the following tool:

  • think: Record a thought with a timestamp

Development

Installation for Development

git clone https://github.com/ddkang1/mcp-think.git
cd mcp-think
pip install -e ".[dev]"

Running Tests

pytest

Code Style

This project uses Black for formatting, isort for import sorting, and flake8 for linting:

black src tests
isort src tests
flake8 src tests

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

Changelog

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

License

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

Metadata

Release files for mcp-think 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-think 0.2.2
File Size Uploaded Provenance
mcp_think-0.2.2.tar.gz 10.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-think 0.2.2
File Interpreter ABI Platform
mcp_think-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 17.5 kB

Release files / mcp_think-0.2.2.tar.gz

Download URL mcp_think-0.2.2.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c405192287e0371f96f970c069659e5723cf8546fa1a4b41be41b44ee408f434
BLAKE2b-256 checksum
How to use checksums
3fa5f9170a75205faa040a07e78f8a9819f7228c8bb65a1de473a3ec6bb72bc3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.10.12

Release files / mcp_think-0.2.2-py3-none-any.whl

Download URL mcp_think-0.2.2-py3-none-any.whl
Size 6.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0f82dee0df6483165d0951782b1a0e2be3738e4ea50f135ff8b5f387a25e534a
BLAKE2b-256 checksum
How to use checksums
6cb51182f50b053622018b99e32125fc530329ac3e7b10bf83e80d074014e8e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.10.12

Security for mcp-think 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page