{"_id":"@waldzellai/clear-thought","_rev":"3-e95570e94cfc7d901150b30e16dd6262","name":"@waldzellai/clear-thought","dist-tags":{"latest":"0.0.4"},"versions":{"0.0.2":{"name":"@waldzellai/clear-thought","version":"0.0.2","keywords":["mcp","sequential-thinking","mental-models","debugging","problem-solving","ai","cognitive-tools"],"author":{"name":"Waldzell AI"},"license":"MIT","_id":"@waldzellai/clear-thought@0.0.2","maintainers":[{"name":"glassbead","email":"glassBead@waldzellai.com"}],"homepage":"https://github.com/waldzellai/clear-thought","bugs":{"url":"https://github.com/waldzellai/clear-thought/issues"},"bin":{"mcp-server-clear-thought":"dist/index.js"},"dist":{"shasum":"e4ad85a35f3d2b41cfb34fdff9868c49df8f9e57","tarball":"https://registry.npmjs.org/@waldzellai/clear-thought/-/clear-thought-0.0.2.tgz","fileCount":5,"integrity":"sha512-fhqulnjTshpSEeTFm2GVTKkr8v+UZNtDcuJHWCJ2ZvsluIMJSe3Nz1+whc0/PL2eoFT8aCKeLjQ8GX3s488yiA==","signatures":[{"sig":"MEQCIAVDENZsok63OIAGL0emEfwFnFQEgxW43O2DGLl6xd3uAiB/AkvtNyJRi37GFQASjuEd2TYwgbGEgmJWQIsMGPCkig==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24513},"type":"module","engines":{"node":">=18"},"gitHead":"ec75da2682025dfe056a9d0bd7f4ff5a58a2737e","scripts":{"build":"npx tsc --listFiles --project tsconfig.json && chmod +x dist/*.js","clean":"rm -rf dist","start":"node dist/index.js","watch":"npx tsc --watch","docker":"docker build -t waldzellai/clear-thought .","prepare":"npm run build","prebuild":"npm run clean","prepublishOnly":"npm run build"},"_npmUser":{"name":"glassbead","email":"glassBead@waldzellai.com"},"repository":{"url":"git+https://github.com/waldzellai/clear-thought.git","type":"git"},"_npmVersion":"10.8.3","description":"MCP server for systematic thinking, mental models, debugging approaches, and memory management","directories":{},"_nodeVersion":"22.6.0","dependencies":{"chalk":"^5.3.0","yargs":"^17.7.2","@types/chalk":"^0.4.31","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^22","@types/yargs":"^17.0.32"},"_npmOperationalInternal":{"tmp":"tmp/clear-thought_0.0.2_1739813532782_0.08081920680775112","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@waldzellai/clear-thought","version":"0.0.3","keywords":["mcp","sequential-thinking","mental-models","debugging","problem-solving","ai","cognitive-tools"],"author":{"name":"Waldzell AI"},"license":"MIT","_id":"@waldzellai/clear-thought@0.0.3","maintainers":[{"name":"glassbead","email":"glassBead@waldzellai.com"}],"homepage":"https://github.com/waldzellai/clear-thought","bugs":{"url":"https://github.com/waldzellai/clear-thought/issues"},"bin":{"mcp-server-clear-thought":"dist/index.js"},"dist":{"shasum":"d1fdb7520c32e85f5633929cab9591e0e7111562","tarball":"https://registry.npmjs.org/@waldzellai/clear-thought/-/clear-thought-0.0.3.tgz","fileCount":5,"integrity":"sha512-lRHqD5R8Aw6JEwh58eNQBQRf4/PBceHagZkcNImlTYlpRnHBcPg3RtRNX5fJiGN/C47LsoG/mQqTK2qrID+g3w==","signatures":[{"sig":"MEQCIDIV1V5F32VSNVH66mPnNHQb0XRbNL0ThEfRub/MtKu4AiBzUayiFEtsB/h87VeZ+odlzUmLDzHar223sP8f6L7gcg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57485},"type":"module","engines":{"node":">=18"},"gitHead":"3c825d54ca65c45b4c453f72dcb112be243952cc","scripts":{"dev":"npm run watch","lint":"echo \"No linting configured\" && exit 0","test":"echo \"No tests yet\" && exit 0","build":"npx tsc --listFiles --project tsconfig.json && chmod +x dist/*.js","clean":"rm -rf dist","start":"node dist/index.js","watch":"npx tsc --watch","deploy":"smithery deploy","docker":"docker build -t waldzellai/clear-thought .","prepare":"npm run build","prebuild":"npm run clean","prepublishOnly":"npm run build"},"_npmUser":{"name":"glassbead","email":"glassBead@waldzellai.com"},"repository":{"url":"git+https://github.com/waldzellai/clear-thought.git","type":"git"},"_npmVersion":"10.8.3","description":"MCP server for systematic thinking, mental models, debugging approaches, and memory management","directories":{},"_nodeVersion":"22.6.0","dependencies":{"chalk":"^5.3.0","yargs":"^17.7.2","@types/chalk":"^0.4.31","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^22","@types/yargs":"^17.0.32"},"_npmOperationalInternal":{"tmp":"tmp/clear-thought_0.0.3_1746696663105_0.947535586876147","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@waldzellai/clear-thought","version":"0.0.4","description":"MCP server for systematic thinking, mental models, debugging approaches, and memory management","license":"MIT","author":{"name":"Waldzell AI"},"homepage":"https://github.com/waldzellai/clear-thought","bugs":{"url":"https://github.com/waldzellai/clear-thought/issues"},"type":"module","bin":{"mcp-server-clear-thought":"dist/index.js"},"scripts":{"build":"npx tsc --listFiles --project tsconfig.json && chmod +x dist/*.js","prepare":"npm run build","watch":"npx tsc --watch","clean":"rm -rf dist","prebuild":"npm run clean","prepublishOnly":"npm run build","start":"node dist/index.js","docker":"docker build -t waldzellai/clear-thought .","dev":"npm run watch","test":"echo \"No tests yet\" && exit 0","lint":"echo \"No linting configured\" && exit 0","deploy":"smithery deploy"},"repository":{"type":"git","url":"git+https://github.com/waldzellai/clear-thought.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.5.0","@types/chalk":"^0.4.31","chalk":"^5.3.0","yargs":"^17.7.2","zod":"^3.25.27"},"devDependencies":{"@types/node":"^22","@types/yargs":"^17.0.32","typescript":"^5.3.3"},"keywords":["mcp","sequential-thinking","mental-models","debugging","problem-solving","ai","cognitive-tools"],"engines":{"node":">=18"},"_id":"@waldzellai/clear-thought@0.0.4","gitHead":"6665911a29f8ac429c8c5ea20e3af69867e0bf58","_nodeVersion":"22.6.0","_npmVersion":"10.8.3","dist":{"integrity":"sha512-GczdNXMmZDC18kU5YXmbqZDdyMb2KRgzDtAfpe8oMIkroq1zs3kHzWLVF0s4p70h2psczyGvVQDFhi1bZPEzeg==","shasum":"1b3401a8e5e3681a6cb13d01c741ce45cdc55619","tarball":"https://registry.npmjs.org/@waldzellai/clear-thought/-/clear-thought-0.0.4.tgz","fileCount":11,"unpackedSize":71026,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCsCG1bkRiIWl7SIPKYXEWAKDHFpyNzz2OaGKhCozz78QIgfFE3cP/yE7PyWB58RnQnCZGpXSuCoUZ3q9HaV+ngKn8="}]},"_npmUser":{"name":"glassbead","email":"glassBead@waldzellai.com"},"directories":{},"maintainers":[{"name":"glassbead","email":"glassBead@waldzellai.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clear-thought_0.0.4_1748372904915_0.9143240836087414"},"_hasShrinkwrap":false}},"time":{"created":"2025-02-17T17:32:12.515Z","modified":"2025-05-27T19:08:25.329Z","0.0.2":"2025-02-17T17:32:12.963Z","0.0.3":"2025-05-08T09:31:03.299Z","0.0.4":"2025-05-27T19:08:25.150Z"},"bugs":{"url":"https://github.com/waldzellai/clear-thought/issues"},"author":{"name":"Waldzell AI"},"license":"MIT","homepage":"https://github.com/waldzellai/clear-thought","keywords":["mcp","sequential-thinking","mental-models","debugging","problem-solving","ai","cognitive-tools"],"repository":{"type":"git","url":"git+https://github.com/waldzellai/clear-thought.git"},"description":"MCP server for systematic thinking, mental models, debugging approaches, and memory management","maintainers":[{"name":"glassbead","email":"glassBead@waldzellai.com"}],"readme":"# Clear Thought MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@waldzellai/clear-thought)](https://smithery.ai/server/@waldzellai/clear-thought)\n\nA Model Context Protocol (MCP) server that provides systematic thinking, mental models, and debugging approaches for enhanced problem-solving capabilities.\n\n## Features\n\n### Mental Models\n- First Principles Thinking\n- Opportunity Cost Analysis\n- Error Propagation Understanding\n- Rubber Duck Debugging\n- Pareto Principle\n- Occam's Razor\n- And many more...\n\n### Design Patterns\n- Modular Architecture\n- API Integration Patterns\n- State Management\n- Asynchronous Processing\n- Scalability Considerations\n- Security Best Practices\n- Agentic Design Patterns\n\nNote: Compatible with various modern web frameworks and architectures.\n\n### Programming Paradigms\n- Imperative Programming\n- Procedural Programming\n- Object-Oriented Programming\n- Functional Programming\n- Declarative Programming\n- Logic Programming\n- Event-Driven Programming\n- Aspect-Oriented Programming\n- Concurrent Programming\n- Reactive Programming\n\n### Debugging Approaches\n- Binary Search\n- Reverse Engineering\n- Divide and Conquer\n- Backtracking\n- Cause Elimination\n- Program Slicing\n- Advanced debugging patterns\n\n### Sequential Thinking\n- Structured thought process\n- Revision and branching support\n- Progress tracking\n- Context maintenance\n\n## Tool Selection Guide\n\nEach tool in the Clear Thought MCP Server has specific strengths. Here are some scenarios where each tool might be particularly useful:\n\n### Mental Models\nBest suited for:\n- Initial problem understanding\n- Breaking down complex systems\n- Analyzing trade-offs\n- Finding root causes\n- Making strategic decisions\n\nExample scenarios:\n- Analyzing system architecture choices\n- Evaluating competing solutions\n- Understanding error patterns\n\n### Design Patterns\nBest suited for:\n- Implementing proven solutions\n- Structuring new features\n- Ensuring maintainable code\n- Scaling applications\n- Managing technical debt\n\nExample scenarios:\n- Building new system components\n- Refactoring existing code\n- Implementing cross-cutting concerns\n\n### Debugging Approaches\nBest suited for:\n- Troubleshooting issues\n- Performance optimization\n- System analysis\n- Error resolution\n- Quality assurance\n\nExample scenarios:\n- Fixing production issues\n- Optimizing slow processes\n- Resolving integration problems\n\n### Sequential Thinking\nBest suited for:\n- Complex problem-solving\n- Multi-step analysis\n- Decision refinement\n- Process improvement\n- Comprehensive planning\n\nExample scenarios:\n- Planning major features\n- Analyzing system-wide changes\n- Making architectural decisions\n\nNote: These are suggestions rather than rules. Tools can be used in any order or combination that best serves your needs.\n\n## Installation\n\n### Installing via Smithery\n\nTo install Clear Thought MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@waldzellai/clear-thought):\n\n```bash\nnpx -y @smithery/cli install @waldzellai/clear-thought --client claude\n```\n\n### Manual Installation\n```bash\nnpm install @waldzellai/clear-thought\n```\n\nOr run with npx:\n\n```bash\nnpx @waldzellai/clear-thought\n```\n\n## Usage\n\n### Mental Models\n```typescript\nconst response = await mcp.callTool(\"mentalmodel\", {\n  modelName: \"first_principles\",\n  problem: \"How to implement a new feature?\",\n  steps: [\n    \"Break down the problem\",\n    \"Analyze components\",\n    \"Build solution\"\n  ]\n});\n```\n\n### Debugging Approaches\n```typescript\nconst response = await mcp.callTool(\"debuggingapproach\", {\n  approachName: \"binary_search\",\n  issue: \"Performance degradation in the system\",\n  steps: [\n    \"Identify performance metrics\",\n    \"Locate bottleneck\",\n    \"Implement solution\"\n  ]\n});\n```\n\n### Sequential Thinking\n```typescript\nconst response = await mcp.callTool(\"sequentialthinking\", {\n  thought: \"Initial analysis of the problem\",\n  thoughtNumber: 1,\n  totalThoughts: 3,\n  nextThoughtNeeded: true\n});\n```\n\n## Docker\n\nBuild the Docker image:\n\n```bash\ndocker build -t waldzellai/clear-thought .\n```\n\nRun the container:\n\n```bash\ndocker run -it waldzellai/clear-thought\n```\n\n## Development\n\n1. Clone the repository\n2. Install dependencies: `npm install`\n3. Build the project: `npm run build`\n4. Start the server: `npm start`\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see LICENSE for details.\n\n## Acknowledgments\n\n- Based on the Model Context Protocol (MCP) by Anthropic, and uses the code for the sequentialthinking server\n- Mental Models framework inspired by [James Clear's comprehensive guide to mental models](https://jamesclear.com/mental-models), which provides an excellent overview of how these thinking tools can enhance decision-making and problem-solving capabilities\n","readmeFilename":"README.md"}