{"id":24788086,"url":"https://github.com/spences10/mcp-sequentialthinking-tools","last_synced_at":"2025-04-10T12:33:23.155Z","repository":{"id":274020747,"uuid":"921652649","full_name":"spences10/mcp-sequentialthinking-tools","owner":"spences10","description":"🧠 An adaptation of the MCP Sequential Thinking Server to guide tool usage. This server provides recommendations for which MCP tools would be most effective at each stage.","archived":false,"fork":false,"pushed_at":"2025-04-01T06:52:07.000Z","size":99,"stargazers_count":71,"open_issues_count":2,"forks_count":13,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T07:37:46.692Z","etag":null,"topics":["mcp","model-context-protocol","modelcontextprotocol","tool"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/spences10.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2025-01-24T11:02:14.000Z","updated_at":"2025-03-31T22:39:16.000Z","dependencies_parsed_at":"2025-01-24T11:44:03.128Z","dependency_job_id":"69307bb5-f4c0-425a-bf29-8e06b949770b","html_url":"https://github.com/spences10/mcp-sequentialthinking-tools","commit_stats":null,"previous_names":["spences10/mcp-sequentialthinking-tools"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-sequentialthinking-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-sequentialthinking-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-sequentialthinking-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-sequentialthinking-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spences10","download_url":"https://codeload.github.com/spences10/mcp-sequentialthinking-tools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248217145,"owners_count":21066633,"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":["mcp","model-context-protocol","modelcontextprotocol","tool"],"created_at":"2025-01-29T16:15:29.567Z","updated_at":"2025-04-10T12:33:23.134Z","avatar_url":"https://github.com/spences10.png","language":"TypeScript","readme":"# mcp-sequentialthinking-tools\n\nAn adaptation of the\n[MCP Sequential Thinking Server](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/index.ts)\ndesigned to guide tool usage in problem-solving. This server helps\nbreak down complex problems into manageable steps and provides\nrecommendations for which MCP tools would be most effective at each\nstage.\n\n\u003ca href=\"https://glama.ai/mcp/servers/zl990kfusy\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/zl990kfusy/badge\" /\u003e\n\u003c/a\u003e\n\nA Model Context Protocol (MCP) server that combines sequential\nthinking with intelligent tool suggestions. For each step in the\nproblem-solving process, it provides confidence-scored recommendations\nfor which tools to use, along with rationale for why each tool would\nbe appropriate.\n\n## Features\n\n- 🤔 Dynamic and reflective problem-solving through sequential\n  thoughts\n- 🔄 Flexible thinking process that adapts and evolves\n- 🌳 Support for branching and revision of thoughts\n- 🛠️ Intelligent tool recommendations for each step\n- 📊 Confidence scoring for tool suggestions\n- 🔍 Detailed rationale for tool recommendations\n- 📝 Step tracking with expected outcomes\n- 🔄 Progress monitoring with previous and remaining steps\n- 🎯 Alternative tool suggestions for each step\n\n## How It Works\n\nThis server analyses each step of your thought process and recommends\nappropriate MCP tools to help accomplish the task. Each recommendation\nincludes:\n\n- A confidence score (0-1) indicating how well the tool matches the\n  current need\n- A clear rationale explaining why the tool would be helpful\n- A priority level to suggest tool execution order\n- Alternative tools that could also be used\n\nThe server works with any MCP tools available in your environment. It\nprovides recommendations based on the current step's requirements, but\nthe actual tool execution is handled by the consumer (like Claude).\n\n## Example Usage\n\nHere's an example of how the server guides tool usage:\n\n```json\n{\n\t\"thought\": \"Initial research step to understand what universal reactivity means in Svelte 5\",\n\t\"current_step\": {\n\t\t\"step_description\": \"Gather initial information about Svelte 5's universal reactivity\",\n\t\t\"expected_outcome\": \"Clear understanding of universal reactivity concept\",\n\t\t\"recommended_tools\": [\n\t\t\t{\n\t\t\t\t\"tool_name\": \"search_docs\",\n\t\t\t\t\"confidence\": 0.9,\n\t\t\t\t\"rationale\": \"Search Svelte documentation for official information\",\n\t\t\t\t\"priority\": 1\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"tool_name\": \"tavily_search\",\n\t\t\t\t\"confidence\": 0.8,\n\t\t\t\t\"rationale\": \"Get additional context from reliable sources\",\n\t\t\t\t\"priority\": 2\n\t\t\t}\n\t\t],\n\t\t\"next_step_conditions\": [\n\t\t\t\"Verify information accuracy\",\n\t\t\t\"Look for implementation details\"\n\t\t]\n\t},\n\t\"thought_number\": 1,\n\t\"total_thoughts\": 5,\n\t\"next_thought_needed\": true\n}\n```\n\nThe server tracks your progress and supports:\n\n- Creating branches to explore different approaches\n- Revising previous thoughts with new information\n- Maintaining context across multiple steps\n- Suggesting next steps based on current findings\n\n## Configuration\n\nThis server requires configuration through your MCP client. Here are\nexamples for different environments:\n\n### Cline Configuration\n\nAdd this to your Cline MCP settings:\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"mcp-sequentialthinking-tools\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"mcp-sequentialthinking-tools\"]\n\t\t}\n\t}\n}\n```\n\n### Claude Desktop with WSL Configuration\n\nFor WSL environments, add this to your Claude Desktop configuration:\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"mcp-sequentialthinking-tools\": {\n\t\t\t\"command\": \"wsl.exe\",\n\t\t\t\"args\": [\n\t\t\t\t\"bash\",\n\t\t\t\t\"-c\",\n\t\t\t\t\"source ~/.nvm/nvm.sh \u0026\u0026 /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-sequentialthinking-tools\"\n\t\t\t]\n\t\t}\n\t}\n}\n```\n\n## API\n\nThe server implements a single MCP tool with configurable parameters:\n\n### sequentialthinking_tools\n\nA tool for dynamic and reflective problem-solving through thoughts,\nwith intelligent tool recommendations.\n\nParameters:\n\n- `thought` (string, required): Your current thinking step\n- `next_thought_needed` (boolean, required): Whether another thought\n  step is needed\n- `thought_number` (integer, required): Current thought number\n- `total_thoughts` (integer, required): Estimated total thoughts\n  needed\n- `is_revision` (boolean, optional): Whether this revises previous\n  thinking\n- `revises_thought` (integer, optional): Which thought is being\n  reconsidered\n- `branch_from_thought` (integer, optional): Branching point thought\n  number\n- `branch_id` (string, optional): Branch identifier\n- `needs_more_thoughts` (boolean, optional): If more thoughts are\n  needed\n- `current_step` (object, optional): Current step recommendation with:\n  - `step_description`: What needs to be done\n  - `recommended_tools`: Array of tool recommendations with confidence\n    scores\n  - `expected_outcome`: What to expect from this step\n  - `next_step_conditions`: Conditions for next step\n- `previous_steps` (array, optional): Steps already recommended\n- `remaining_steps` (array, optional): High-level descriptions of\n  upcoming steps\n\n## Development\n\n### Setup\n\n1. Clone the repository\n2. Install dependencies:\n\n```bash\npnpm install\n```\n\n3. Build the project:\n\n```bash\npnpm build\n```\n\n4. Run in development mode:\n\n```bash\npnpm dev\n```\n\n### Publishing\n\nThe project uses changesets for version management. To publish:\n\n1. Create a changeset:\n\n```bash\npnpm changeset\n```\n\n2. Version the package:\n\n```bash\npnpm changeset version\n```\n\n3. Publish to npm:\n\n```bash\npnpm release\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Built on the\n  [Model Context Protocol](https://github.com/modelcontextprotocol)\n- Adapted from the\n  [MCP Sequential Thinking Server](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/index.ts)\n","funding_links":[],"categories":["📚 Projects (1974 total)","HarmonyOS","Other Tools and Integrations","Task and Project Management","TypeScript","🔧 Utilities","AI Integration MCP Servers","MCP Servers"],"sub_categories":["MCP Servers","Windows Manager","How to Submit","Knowledge \u0026 Memory"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspences10%2Fmcp-sequentialthinking-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspences10%2Fmcp-sequentialthinking-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspences10%2Fmcp-sequentialthinking-tools/lists"}