MCP-Think

MCP-Think is a Model Context Protocol (MCP) server that implements a "Think Tool" for LLMs. This tool allows LLMs to record and retrieve their thinking processes during reasoning.

YOLO

curl -fsSL https://raw.githubusercontent.com/iamwavecut/MCP-Think/main/install.sh | bash

Features

• Think Tool: Record thoughts and reasoning steps
• Get Thoughts: Retrieve all previously recorded thoughts
• Clear Thoughts: Clear all recorded thoughts
• Get Thought Stats: Get statistics about recorded thoughts

Installation

There are several ways to install and run MCP-Think:

Installing via Smithery

To install mcp-think for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @iamwavecut/mcp-think --client claude

1. Pre-built Binaries (Recommended for Standalone Use)

Ready-to-use binaries for Linux, Windows, and macOS (amd64 & arm64) are automatically built and attached to each GitHub Release. This is the easiest way to get started if you don't need to modify the code.

• macOS/Linux Auto-Install Script: (see YOLO)

  The script automatically detects your OS and architecture, downloads the appropriate binary, and guides you through installation.

• Manual Installation (incl. Windows):

  1. Go to the Releases page.
  2. Download the appropriate binary for your system (e.g., think-tool-linux-amd64, think-tool-windows-amd64.exe, think-tool-darwin-arm64).
  3. (Optional) Rename it: mv think-tool-linux-amd64 think-tool
  4. Make it executable (Linux/macOS): chmod +x think-tool
  5. Run it: ./think-tool (See Usage section)

2. Using go install (Requires Go)

This command compiles and installs the binary into your Go bin directory ($GOPATH/bin or $HOME/go/bin).

go install github.com/iamwavecut/MCP-Think@latest

• Note: Ensure your Go bin directory is in your system's PATH. You might need to add export PATH=$PATH:$(go env GOPATH)/bin or export PATH=$PATH:$HOME/go/bin to your shell profile (~/.bashrc, ~/.zshrc, etc.).
• Run the installed binary: MCP-Think

3. Using go run (Quick Testing, Requires Go)

This command compiles and runs the main package directly from the source code without installing a binary. It's useful for quick tests.

go run github.com/iamwavecut/MCP-Think@latest

• This downloads the module and its dependencies temporarily if needed.

Requirements

• Go 1.24 or higher (if building from source or using go install/go run)

Usage

Running the Standalone Server

If you installed via Pre-built Binary or go install:

# If using pre-built binary in current directory:
./think-tool

# If installed via 'go install' or the install script to /usr/local/bin:
think-tool

If you are using go run:

go run github.com/iamwavecut/MCP-Think@latest

The server will print Starting Think Tool MCP Server with stdio transport... and wait for MCP requests on stdin.

Setting up in Cursor

To use MCP-Think with Cursor, follow these steps:

1. Install MCP-Think using one of the installation methods above
2. Create or update your Cursor MCP configuration file at ~/.cursor/mcp.json:

{
  "mcpServers": {
    "think-tool": {
      "command": "think-tool", // or absolute path, f.e.: /opt/bin/think-tool
      "transport": "stdio"
    }
  }
}

1. Add the following rule to your Cursor rules:

## Using the think tool
Before taking any action or responding to the user after receiving tool results, use the think tool as a scratchpad to:

List the specific rules that apply to the current request
Check if all required information is collected
Verify that the planned action complies with all policies
Iterate over tool results for correctness

Here are some examples of what to iterate over inside the think tool:
<think_tool_example_1>
User wants to cancel flight ABC123

Need to verify: user ID, reservation ID, reason
Check cancellation rules:

Is it within 24h of booking?
If not, check ticket class and insurance


Verify no segments flown or are in the past
Plan: collect missing info, verify rules, get confirmation
</think_tool_example_1>

<think_tool_example_2>
User wants to book 3 tickets to NYC with 2 checked bags each

Need user ID to check:

Membership tier for baggage allowance
Which payments methods exist in profile


Baggage calculation:

Economy class × 3 passengers
If regular member: 1 free bag each → 3 extra bags = $150
If silver member: 2 free bags each → 0 extra bags = $0
If gold member: 3 free bags each → 0 extra bags = $0


Payment rules to verify:

Max 1 travel certificate, 1 credit card, 3 gift cards
All payment methods must be in profile
Travel certificate remainder goes to waste


Plan:


Get user ID
Verify membership level for bag fees
Check which payment methods in profile and if their combination is allowed
Calculate total: ticket price + any bag fees
Get explicit confirmation for booking
</think_tool_example_2>