{"id":30805544,"url":"https://github.com/aaronsb/think-strategies","last_synced_at":"2025-09-06T00:58:54.038Z","repository":{"id":290477084,"uuid":"974585658","full_name":"aaronsb/think-strategies","owner":"aaronsb","description":"An MCP server that provides structured thinking strategies for breaking down complex problems into manageable steps with support for revisions, branching, and multiple reasoning approaches","archived":false,"fork":false,"pushed_at":"2025-08-04T22:32:00.000Z","size":1720,"stargazers_count":7,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-05T00:38:50.346Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronsb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-29T02:19:24.000Z","updated_at":"2025-08-04T22:32:03.000Z","dependencies_parsed_at":"2025-08-05T00:10:34.631Z","dependency_job_id":null,"html_url":"https://github.com/aaronsb/think-strategies","commit_stats":null,"previous_names":["aaronsb/sequentialthinking-plus","aaronsb/think-strategies"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aaronsb/think-strategies","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fthink-strategies","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fthink-strategies/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fthink-strategies/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fthink-strategies/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronsb","download_url":"https://codeload.github.com/aaronsb/think-strategies/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fthink-strategies/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273842823,"owners_count":25177921,"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","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-09-06T00:58:49.864Z","updated_at":"2025-09-06T00:58:54.018Z","avatar_url":"https://github.com/aaronsb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Think Strategies MCP Server\n\n\u003cp align=\"center\"\u003e\n  \u003ch2\u003e🧠 Think Strategies\u003c/h2\u003e\n  \u003cp\u003e\u003cem\u003e10 Reasoning Strategies for Structured Problem-Solving\u003c/em\u003e\u003c/p\u003e\n\u003c/p\u003e\n\n## Overview\n\nAn MCP server implementation that provides a tool for dynamic and reflective problem-solving through structured thinking processes. Choose from 10 different reasoning strategies:\n\n- **🔄 Linear** - Flexible thinking with revisions and branches\n- **🔗 Chain of Thought** - Sequential step-by-step reasoning\n- **🎯 React** - Reasoning combined with actions and observations\n- **📋 ReWOO** - Plan-execute pattern with parallel tool usage\n- **📝 Scratchpad** - Iterative calculations with state tracking\n- **❓ Self-Ask** - Decompose into sub-questions and answers\n- **🔍 Self-Consistency** - Multiple reasoning paths to consensus\n- **🔭 Step-Back** - Abstract principles before specific application\n- **🌳 Tree of Thoughts** - Explore and evaluate multiple branches\n- **⚖️ Trilemma** - Balance three competing objectives through satisficing\n\n## Documentation\n\nComprehensive documentation is available in the following files:\n\n- [Executive Summary](./docs/SequentialThinking-ExecutiveSummary.md) - High-level overview of Sequential Thinking\n- [Practical Guide](./docs/SequentialThinking-PracticalGuide.md) - Examples and best practices for using the tool (includes trilemma scenarios)\n- [Technical Documentation](./docs/SequentialThinking-Documentation.md) - Detailed technical explanation of the architecture\n- [Flow Engine Architecture](./docs/SequentialThinking-FlowEngine.md) - In-depth explanation of the flow engine's flexibility and strategy-specific flows\n- [Strategy Comparison](./docs/strategy-comparison.md) - Detailed comparison of all 10 thinking strategies including trilemma\n\n## Features\n\n- Break down complex problems into manageable steps\n- Revise and refine thoughts as understanding deepens\n- Branch into alternative paths of reasoning\n- Adjust the total number of thoughts dynamically\n- Support for unfixed step numbers through cyclic flows\n- Strategy-specific flow patterns for different reasoning approaches\n- Generate and verify solution hypotheses\n\n## Architecture\n\nThe think-strategies server uses a **consolidated 3-tool architecture** designed for optimal balance between simplicity and power:\n\n### Core Tools\n\n#### 1. `think-strategies` (Core Thinking)\nFacilitates structured problem-solving with prominent strategy selection.\n\n**Parameters (7):**\n- `strategy` (string): **Primary choice** - one of 10 reasoning strategies\n- `thought` (string): The current thinking step\n- `thoughtNumber` (integer): Current thought number (uses dual A1|S1 numbering)\n- `totalThoughts` (integer): Estimated total thoughts needed\n- `nextThoughtNeeded` (boolean): Whether another thought step is needed\n- `plannedActions` (array, optional): Plan tool calls for think→act→reflect workflow\n- `actionResults` (array, optional): Integrate results from executed tools\n- `action` (string, optional): Strategy-specific action (for ReAct, ReWOO)\n- `observation` (string, optional): Strategy-specific observation\n- `finalAnswer` (string, optional): Final result when thinking is complete\n\n#### 2. `think-tools` (Action-Based Utilities)\nConsolidated utilities with action-based routing.\n\n**Parameters (6):**\n- `action` (string): \"connect-server\" | \"execute-actions\" | \"server-status\" | \"create-branch\"\n- `serverName` (string, optional): MCP server name for connections\n- `command` (string, optional): Command to execute\n- `args` (array, optional): Command arguments\n- `branchId` (string, optional): Branch identifier for branching\n- `branchFromThought` (number, optional): Thought number to branch from\n- `thought` (string, optional): Context for branching\n\n#### 3. `think-session-manager` (Session Operations)\nManage thinking session persistence and continuity.\n\n**Parameters (3):**\n- `action` (string): \"list\" | \"get\" | \"resume\"\n- `sessionId` (string, optional): Specific session ID\n- `limit` (number, optional): Number of sessions to return (default: 10)\n\n### Key Features\n\n- **Strategy Selection Prominence**: Clear choice among 10 reasoning strategies\n- **Think→Act→Reflect Workflow**: Seamless integration with any available tools\n- **Dual Numbering System**: Absolute (A1, A2...) and sequence-relative (S1, S2...) tracking\n- **True Branching**: Create alternative reasoning paths\n- **Session Continuity**: Persistent sessions with resume capability\n- **MCP Integration**: Connect to other MCP servers during thinking\n- **No Tool Duplication**: Clean separation of concerns across 3 focused tools\n\n### Resources\n\n- **documentation**: Complete tool documentation and usage examples\n- **strategy-config**: Configuration for all 10 thinking strategies and their stage flows\n\n## Usage\n\n### When to Use Think-Strategies\n\nThe think-strategies server is designed for:\n- **Complex Problem-Solving**: Break down multi-step challenges into manageable pieces\n- **Strategic Analysis**: Choose the optimal reasoning approach for your specific problem type\n- **Iterative Refinement**: Revise and improve your thinking as understanding deepens\n- **Alternative Exploration**: Branch into different solution paths and compare approaches\n- **Tool Integration**: Combine reasoning with real tool execution (think\\u2192act\\u2192reflect)\n- **Session Continuity**: Resume and build upon previous thinking sessions\n\n### Strategy Selection Guide\n\n- **Linear/Chain of Thought**: Step-by-step reasoning for straightforward problems\n- **ReAct**: When you need to gather information or execute actions during reasoning\n- **ReWOO**: For parallel tool usage and plan-execute workflows\n- **Tree of Thoughts**: When exploring multiple solution branches is valuable\n- **Trilemma**: For balancing three competing objectives through satisficing\n- **Self-Ask**: Break complex questions into simpler sub-questions\n- **Step-Back**: When you need to establish principles before diving into specifics\n\n## Installation\n\n### Prerequisites\n\n- Node.js (v14 or higher) and npm (v6 or higher)\n  OR\n- Docker\n\n### Quick Start with npx (Easiest)\n\nYou can run the server directly using npx without cloning or installing:\n\n```bash\n# Run from npm registry (after publishing)\nnpx think-strategies\n\n# Or run directly from GitHub\nnpx github:aaronsb/think-strategies\n```\n\n### Setup with Node.js\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/aaronsb/think-strategies.git\ncd think-strategies\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Make the server executable:\n```bash\nchmod +x index.js\n```\n\n4. Run the server:\n```bash\nnode index.js\n```\n\n### Setup with Docker\n\n#### Using Pre-built Image (Recommended)\n\nPull and run the latest image from GitHub Container Registry:\n```bash\ndocker run --rm -i ghcr.io/aaronsb/think-strategies:latest\n```\n\n#### Building Locally\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/aaronsb/think-strategies.git\ncd think-strategies\n```\n\n2. Build the Docker image:\n```bash\n./scripts/build-local.sh\n```\n\n3. Run the Docker container:\n```bash\n./scripts/run-local.sh\n```\n\nThis will run the server with the correct permissions, ensuring that any files created are owned by the current user, not root.\n\n### Development\n\nTo contribute to the project:\n\n1. Fork the repository on GitHub\n2. Clone your fork locally\n3. Add the upstream repository:\n```bash\ngit remote add upstream https://github.com/aaronsb/think-strategies.git\n```\n4. Create a branch for your changes\n5. Submit a pull request with your changes\n\n## Configuration\n\n### Using Claude Code CLI (Recommended)\n\nAdd the think-strategies MCP server using Claude Code's built-in command:\n\n```bash\n# Add from GitHub (latest version)\nclaude mcp add think-strategies \"npx\" \"github:aaronsb/think-strategies\" -- --storage-path \"/home/$(whoami)/Documents/thinking\"\n\n# Add from local development path\nclaude mcp add think-strategies \"node\" \"/path/to/think-strategies/index.js\" -- --storage-path \"/home/$(whoami)/Documents/thinking\"\n\n# Add with Docker\nclaude mcp add think-strategies \"docker\" \"run\" \"--rm\" \"-i\" \"--user\" \"$(id -u):$(id -g)\" \"-v\" \"/home/$(whoami)/Documents/thinking:/app/data\" \"ghcr.io/aaronsb/think-strategies:latest\"\n\n# Optional: Use user scope to share thinking sessions across all projects\nclaude mcp add --scope user think-strategies \"npx\" \"github:aaronsb/think-strategies\" -- --storage-path \"/home/$(whoami)/Documents/thinking\"\n```\n\n**Scope Options:**\n- **Local** (default): Server available only in current project directory\n- **User** (recommended): Server available globally, allowing you to access all thinking sessions across projects and build a comprehensive knowledge base\n\n### Manual Configuration\n\n#### Usage with Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n#### Using npx (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"think-strategies\": {\n      \"autoApprove\": [\"think-strategies\", \"think-tools\", \"think-session-manager\"],\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"command\": \"npx\",\n      \"args\": [\n        \"github:aaronsb/think-strategies\",\n        \"--storage-path\",\n        \"/path/to/thinking/storage\"\n      ],\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\n### Usage with Cline\n\nAdd this to your `cline_mcp_settings.json`:\n\n#### Using npx (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"think-strategies\": {\n      \"autoApprove\": [\"think-strategies\", \"think-tools\", \"think-session-manager\"],\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"command\": \"npx\",\n      \"args\": [\n        \"github:aaronsb/think-strategies\"\n      ],\n      \"env\": {},\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\n#### Using Node.js\n\n```json\n{\n  \"mcpServers\": {\n    \"think-strategies\": {\n      \"autoApprove\": [\"think-strategies\", \"think-tools\", \"think-session-manager\"],\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/repo/think-strategies/index.js\"\n      ],\n      \"env\": {},\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\n#### Using Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"think-strategies\": {\n      \"autoApprove\": [\"think-strategies\", \"think-tools\", \"think-session-manager\"],\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"--user\",\n        \"$(id -u):$(id -g)\",\n        \"-v\",\n        \"/tmp/sequentialthinking-plus-data:/app/data\",\n        \"ghcr.io/aaronsb/think-strategies:latest\"\n      ],\n      \"env\": {},\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\n## License\n\nThis MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fthink-strategies","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronsb%2Fthink-strategies","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fthink-strategies/lists"}