{"id":29114334,"url":"https://github.com/iamwavecut/mcp-think","last_synced_at":"2026-01-12T02:38:45.478Z","repository":{"id":284747465,"uuid":"955904219","full_name":"iamwavecut/MCP-Think","owner":"iamwavecut","description":"MCP Think tool prebuilt binaries and code","archived":false,"fork":false,"pushed_at":"2025-03-27T15:16:11.000Z","size":39,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T13:13:17.889Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamwavecut.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-27T11:37:37.000Z","updated_at":"2025-06-03T08:58:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"6a167233-6d97-4bf4-a5c7-fa242005c4c2","html_url":"https://github.com/iamwavecut/MCP-Think","commit_stats":null,"previous_names":["iamwavecut/mcp-think"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/iamwavecut/MCP-Think","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamwavecut%2FMCP-Think","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamwavecut%2FMCP-Think/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamwavecut%2FMCP-Think/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamwavecut%2FMCP-Think/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamwavecut","download_url":"https://codeload.github.com/iamwavecut/MCP-Think/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamwavecut%2FMCP-Think/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262581404,"owners_count":23331915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-29T11:06:18.045Z","updated_at":"2026-01-12T02:38:45.471Z","avatar_url":"https://github.com/iamwavecut.png","language":"Go","funding_links":[],"categories":["Knowledge \u0026 Memory"],"sub_categories":[],"readme":"# MCP-Think\n[![smithery badge](https://smithery.ai/badge/@iamwavecut/mcp-think)](https://smithery.ai/server/@iamwavecut/mcp-think)\n\nMCP-Think is a Model Context Protocol (MCP) server that implements a \"[Think Tool](https://www.anthropic.com/engineering/claude-think-tool)\" for LLMs. This tool allows LLMs to record and retrieve their thinking processes during reasoning.\n---\n\n# YOLO\n```bash\ncurl -fsSL https://raw.githubusercontent.com/iamwavecut/MCP-Think/main/install.sh | bash\n```\n\n## Features\n\n- **Think Tool**: Record thoughts and reasoning steps\n- **Get Thoughts**: Retrieve all previously recorded thoughts\n- **Clear Thoughts**: Clear all recorded thoughts\n- **Get Thought Stats**: Get statistics about recorded thoughts\n\n## Installation\n\nThere are several ways to install and run MCP-Think:\n\n### Installing via Smithery\n\nTo install mcp-think for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@iamwavecut/mcp-think):\n\n```bash\nnpx -y @smithery/cli install @iamwavecut/mcp-think --client claude\n```\n\n### 1. Pre-built Binaries (Recommended for Standalone Use)\n\nReady-to-use binaries for Linux, Windows, and macOS (amd64 \u0026 arm64) are automatically built and attached to each [GitHub Release](https://github.com/iamwavecut/MCP-Think/releases). This is the easiest way to get started if you don't need to modify the code.\n\n*   #### macOS/Linux Auto-Install Script: (see YOLO)\n    *The script automatically detects your OS and architecture, downloads the appropriate binary, and guides you through installation.*\n\n*   #### Manual Installation (incl. Windows):\n    1.  Go to the [Releases page](https://github.com/iamwavecut/MCP-Think/releases).\n    2.  Download the appropriate binary for your system (e.g., `think-tool-linux-amd64`, `think-tool-windows-amd64.exe`, `think-tool-darwin-arm64`).\n    3.  (Optional) Rename it: `mv think-tool-linux-amd64 think-tool`\n    4.  Make it executable (Linux/macOS): `chmod +x think-tool`\n    5.  Run it: `./think-tool` (See Usage section)\n\n\n\n### 2. Using `go install` (Requires Go)\n\nThis command compiles and installs the binary into your Go bin directory (`$GOPATH/bin` or `$HOME/go/bin`).\n\n```bash\ngo install github.com/iamwavecut/MCP-Think@latest\n```\n\n*   **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.).\n*   Run the installed binary: `MCP-Think`\n\n**3. Using `go run` (Quick Testing, Requires Go)**\n\nThis command compiles and runs the `main` package directly from the source code without installing a binary. It's useful for quick tests.\n\n```bash\ngo run github.com/iamwavecut/MCP-Think@latest\n```\n*   This downloads the module and its dependencies temporarily if needed.\n\n### Requirements\n\n-   Go 1.24 or higher (if building from source or using `go install`/`go run`)\n\n## Usage\n\n### Running the Standalone Server\n\nIf you installed via **Pre-built Binary** or **`go install`**:\n\n```bash\n# If using pre-built binary in current directory:\n./think-tool\n\n# If installed via 'go install' or the install script to /usr/local/bin:\nthink-tool\n```\n\nIf you are using **`go run`**:\n\n```bash\ngo run github.com/iamwavecut/MCP-Think@latest\n```\n\nThe server will print `Starting Think Tool MCP Server with stdio transport...` and wait for MCP requests on stdin.\n\n### Setting up in Cursor\n\nTo use MCP-Think with Cursor, follow these steps:\n\n1. Install MCP-Think using one of the installation methods above\n2. Create or update your Cursor MCP configuration file at `~/.cursor/mcp.json`:\n\n```javascript\n{\n  \"mcpServers\": {\n    \"think-tool\": {\n      \"command\": \"think-tool\", // or absolute path, f.e.: /opt/bin/think-tool\n      \"transport\": \"stdio\"\n    }\n  }\n}\n```\n![Cursor MCP should be initialized](https://github.com/user-attachments/assets/addb8439-8259-4d3f-a055-773d9819468d)\n\n3. Add the following rule to your Cursor rules:\n\u003cdetails\u003e\n\u003csummary\u003eCursor settings \u003e Rules \u003e User rules\u003c/summary\u003e\n\u003cpre\u003e\n## Using the think tool\n\nBefore taking any action or responding to the user after receiving tool results, use the think tool as a scratchpad to:\n- List the specific rules that apply to the current request\n- Check if all required information is collected\n- Verify that the planned action complies with all policies\n- Iterate over tool results for correctness \n\nHere are some examples of what to iterate over inside the think tool:\n\u003cthink_tool_example_1\u003e\nUser wants to cancel flight ABC123\n- Need to verify: user ID, reservation ID, reason\n- Check cancellation rules:\n  * Is it within 24h of booking?\n  * If not, check ticket class and insurance\n- Verify no segments flown or are in the past\n- Plan: collect missing info, verify rules, get confirmation\n\u003c/think_tool_example_1\u003e\n\n\u003cthink_tool_example_2\u003e\nUser wants to book 3 tickets to NYC with 2 checked bags each\n- Need user ID to check:\n  * Membership tier for baggage allowance\n  * Which payments methods exist in profile\n- Baggage calculation:\n  * Economy class × 3 passengers\n  * If regular member: 1 free bag each → 3 extra bags = $150\n  * If silver member: 2 free bags each → 0 extra bags = $0\n  * If gold member: 3 free bags each → 0 extra bags = $0\n- Payment rules to verify:\n  * Max 1 travel certificate, 1 credit card, 3 gift cards\n  * All payment methods must be in profile\n  * Travel certificate remainder goes to waste\n- Plan:\n1. Get user ID\n2. Verify membership level for bag fees\n3. Check which payment methods in profile and if their combination is allowed\n4. Calculate total: ticket price + any bag fees\n5. Get explicit confirmation for booking\n\u003c/think_tool_example_2\u003e\n\u003c/pre\u003e\n\u003c/details\u003e\n3. Cursor can now use the Think Tool in your Cursor conversations with Claude 3.7 Sonnet\n\n![image](https://github.com/user-attachments/assets/e90f61ab-0609-4bd7-961d-f64c49dd15c7)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamwavecut%2Fmcp-think","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamwavecut%2Fmcp-think","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamwavecut%2Fmcp-think/lists"}