{"_id":"@waldzellai/clear-thought-onepointfive","_rev":"2-aa05ebff855114feac65b8de71496291","name":"@waldzellai/clear-thought-onepointfive","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.0":{"name":"@waldzellai/clear-thought-onepointfive","version":"0.2.0","keywords":["mcp","modelcontextprotocol","reasoning","sd","complex-systems","tree-of-thought","mcts","graph-of-thought","beam-search","chain-of-thought","sequential-thinking","mental-models","james-clear","cognitive-tools","model-enhancement","sequentialthinking"],"author":{"name":"Waldzell AI"},"license":"MIT","_id":"@waldzellai/clear-thought-onepointfive@0.2.0","maintainers":[{"name":"glassbead","email":"glassBead@waldzellai.com"}],"homepage":"https://github.com/waldzellai/clear-thought-onepointfive.git","bugs":{"url":"https://github.com/waldzellai/clear-thought-onepointfive/issues"},"bin":{"clear-thought":"dist/cli/stdio-server.js"},"dist":{"shasum":"63a09e6e5b85ccafcb0cd19241e0533e3a8f9f44","tarball":"https://registry.npmjs.org/@waldzellai/clear-thought-onepointfive/-/clear-thought-onepointfive-0.2.0.tgz","fileCount":31,"integrity":"sha512-LeQYJWV5nfCn9amhR2mIX9fOu6e+eGoL0v0eyiixflHAIZP5QIQ4HBYITuGLNdtXMUg3OcHIgQZ+jH16oeoQGw==","signatures":[{"sig":"MEYCIQC01rfWmrL44bCK6c8g7mdylodPJpqoj8U9CnH5JDorqwIhAPuUJVcuRPzJ/ZNzQ6b+e0ImKu8ea1T3yAZSdriDUx2f","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":321163},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","module":"./src/index.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"3b678827a2e3448156dfcc61f7ac4da5321930a7","scripts":{"dev":"npx @smithery/cli dev","test":"vitest","build":"npm run build:stdio && npm run build:http && npm run copy-resources","check":"npx @biomejs/biome check --write --unsafe","version":"npm run check && git add -A","typecheck":"tsc --noEmit","build:http":"npx @smithery/cli build","build:stdio":"tsc cli/stdio-server.ts --outDir dist --module esnext --target es2020 --moduleResolution node --esModuleInterop true","postversion":"git push && git push --tags","copy-resources":"mkdir -p dist/resources && cp -r src/resources/* dist/resources/","prepublishOnly":"npm run build && npm run typecheck"},"_npmUser":{"name":"glassbead","email":"glassBead@waldzellai.com"},"repository":{"url":"git+https://github.com/waldzellai/clear-thought-onepointfive.git","type":"git"},"_npmVersion":"10.8.2","description":"Clear Thought MCP server with modular architecture - 38 reasoning operations for systematic thinking","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^3.23.8","marked":"^15.0.12","@smithery/sdk":"^1.5.5","@mcp-ui/server":"^5.2.0","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^22","@smithery/cli":"^1.2.4"},"_npmOperationalInternal":{"tmp":"tmp/clear-thought-onepointfive_0.2.0_1755475586735_0.9240842675451837","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@waldzellai/clear-thought-onepointfive","version":"0.2.1","description":"Clear Thought MCP server with modular architecture - 38 reasoning operations for systematic thinking","license":"MIT","author":{"name":"Waldzell AI"},"homepage":"https://github.com/waldzellai/clear-thought-onepointfive.git","bugs":{"url":"https://github.com/waldzellai/clear-thought-onepointfive/issues"},"type":"module","module":"./src/index.ts","main":"dist/src/index.js","types":"dist/src/index.d.ts","exports":{".":{"import":"./dist/src/index.js","types":"./dist/src/index.d.ts"}},"bin":{"clear-thought":"dist/cli/stdio-server.js"},"scripts":{"build:stdio":"tsc cli/stdio-server.ts --outDir dist --module esnext --target es2020 --moduleResolution node --esModuleInterop true","build:http":"npx @smithery/cli build","copy-resources":"mkdir -p dist/resources && cp -r src/resources/* dist/resources/","build":"npm run build:stdio && npm run build:http && npm run copy-resources","dev":"npx @smithery/cli dev","typecheck":"tsc --noEmit","check":"npx @biomejs/biome check --write --unsafe","test":"vitest","prepublishOnly":"npm run build && npm run typecheck","version":"npm run check && git add -A","postversion":"git push && git push --tags"},"repository":{"type":"git","url":"git+https://github.com/waldzellai/clear-thought-onepointfive.git"},"dependencies":{"@mcp-ui/server":"^5.2.0","@modelcontextprotocol/sdk":"^1.17.0","@smithery/sdk":"^1.5.5","@types/marked":"^5.0.2","marked":"^15.0.12","zod":"^3.23.8"},"devDependencies":{"@smithery/cli":"^1.2.4","@types/node":"^22","typescript":"^5.3.3"},"keywords":["mcp","modelcontextprotocol","reasoning","sd","complex-systems","tree-of-thought","mcts","graph-of-thought","beam-search","chain-of-thought","sequential-thinking","mental-models","james-clear","cognitive-tools","model-enhancement","sequentialthinking"],"engines":{"node":">=18"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_id":"@waldzellai/clear-thought-onepointfive@0.2.1","gitHead":"3b678827a2e3448156dfcc61f7ac4da5321930a7","_nodeVersion":"20.19.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-yQomhu+48r71vC/xpqwQJ/AKGOJLWlCeQhaUwezFOVNkoLsE2fN7f77QTHH73hXQyj6dlS/jt/flRhc/bYtBYw==","shasum":"d0371901e8879ae86954f45f453cbd80f8dd5033","tarball":"https://registry.npmjs.org/@waldzellai/clear-thought-onepointfive/-/clear-thought-onepointfive-0.2.1.tgz","fileCount":31,"unpackedSize":321570,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIERMm/x042vlbkd810V+n3T1AmD2/JsuPixKh301x6igAiB2L2WEep/FUCxEWcRUxVmh9Luunx0aV40Zt9LL81PQ8A=="}]},"_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-onepointfive_0.2.1_1755477282611_0.26674686841916073"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-18T00:06:26.637Z","modified":"2025-08-18T00:34:42.987Z","0.2.0":"2025-08-18T00:06:27.056Z","0.2.1":"2025-08-18T00:34:42.803Z"},"bugs":{"url":"https://github.com/waldzellai/clear-thought-onepointfive/issues"},"author":{"name":"Waldzell AI"},"license":"MIT","homepage":"https://github.com/waldzellai/clear-thought-onepointfive.git","keywords":["mcp","modelcontextprotocol","reasoning","sd","complex-systems","tree-of-thought","mcts","graph-of-thought","beam-search","chain-of-thought","sequential-thinking","mental-models","james-clear","cognitive-tools","model-enhancement","sequentialthinking"],"repository":{"type":"git","url":"git+https://github.com/waldzellai/clear-thought-onepointfive.git"},"description":"Clear Thought MCP server with modular architecture - 38 reasoning operations for systematic thinking","maintainers":[{"name":"glassbead","email":"glassBead@waldzellai.com"}],"readme":"# Clear Thought 1.5 MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@waldzellai/clear-thought-onepointfive)](https://smithery.ai/server/@waldzellai/clear-thought-onepointfive)\n\nA Model Context Protocol (MCP) server that provides a unified reasoning tool with multiple operations, including systematic thinking, mental models, debugging approaches, and interactive notebook capabilities for enhanced problem-solving. This server exposes a single `clear_thought` tool with a comprehensive suite of operations to facilitate complex reasoning tasks, plus interactive Srcbook notebook resources.\n\n## 🚀 New: Modular Architecture\n\nThe codebase has been completely refactored from a monolithic 2867-line file into a clean, modular architecture with 38 separate operations organized by category. Each operation is now self-contained, making the codebase more maintainable, testable, and extensible.\n\n## Operations\n\nThe `clear_thought` tool provides the following operations. For detailed information on parameters, please refer to the operations guide resource at `guide://clear-thought-operations`.\n\n### Core Thinking Operations\n- **sequential_thinking**: Executes a chain-of-thought process. Can be configured to use different reasoning patterns like 'tree', 'beam', 'mcts', 'graph', or 'auto'.\n- **mental_model**: Applies a specified mental model to a problem.\n- **debugging_approach**: Guides through a structured debugging process.\n- **creative_thinking**: Facilitates idea generation and exploration.\n- **visual_reasoning**: Works with diagrams and visual structures.\n- **metacognitive_monitoring**: Monitors and assesses the reasoning process itself.\n- **scientific_method**: Follows the steps of the scientific method for inquiry.\n\n### Collaborative & Decision Operations\n- **collaborative_reasoning**: Simulates a multi-persona discussion to explore a topic from different viewpoints.\n- **decision_framework**: Uses a structured framework to analyze options and make decisions.\n- **socratic_method**: Employs a question-driven approach to challenge and refine arguments.\n- **structured_argumentation**: Constructs and analyzes formal arguments.\n\n### Systems & Analysis Operations\n- **systems_thinking**: Models a problem as a system with interconnected components.\n- **research**: Generates placeholders for research findings and citations.\n- **analogical_reasoning**: Draws parallels and maps insights between different domains.\n- **causal_analysis**: Investigates cause-and-effect relationships.\n- **statistical_reasoning**: Performs statistical analysis (summary, bayes, hypothesis_test, monte_carlo modes).\n- **simulation**: Runs simple simulations.\n- **optimization**: Finds the best solution from a set of alternatives.\n- **ethical_analysis**: Evaluates a situation using an ethical framework.\n\n### Advanced Operations\n- **visual_dashboard**: Creates a skeleton for a visual dashboard.\n- **custom_framework**: Allows defining a custom reasoning framework.\n- **code_execution**: Executes code in a restricted environment (currently Python only).\n- **tree_of_thought, beam_search, mcts, graph_of_thought**: Aliases for `sequential_thinking` with a fixed reasoning pattern.\n- **orchestration_suggest**: Suggests a sequence of tools to use for a complex task.\n\n### Session Management\n- **session_info**: Get information about the current reasoning session.\n- **session_export**: Export session data for persistence.\n- **session_import**: Import session data to restore state.\n\n### Metagame Operations\n- **ooda_loop**: Implements the OODA (Observe, Orient, Decide, Act) loop methodology.\n- **ulysses_protocol**: High-stakes debugging and problem-solving framework.\n\n### Notebook Operations\n- **notebook_create**: Create a new interactive Srcbook notebook.\n- **notebook_add_cell**: Add cells to an existing notebook.\n- **notebook_run_cell**: Execute cells in a notebook.\n- **notebook_export**: Export notebook content.\n\n## Choosing an Operation\n\nWith a wide range of operations available, it's helpful to have a guide for selecting the best one for your task.\n\n- For **general problem-solving** and step-by-step reasoning, start with `sequential_thinking`.\n- To **analyze a problem from a specific viewpoint**, use `mental_model`.\n- When **troubleshooting issues**, `debugging_approach` provides a structured workflow.\n- To **generate new ideas**, use `creative_thinking`.\n- For **complex decisions**, `decision_framework` can help you weigh your options.\n- To **simulate a discussion** with multiple perspectives, use `collaborative_reasoning`.\n- For **high-stakes debugging**, use `ulysses_protocol` with systematic phases and gates.\n- For **rapid decision-making**, use `ooda_loop` for iterative observe-orient-decide-act cycles.\n- For **interactive learning**, use notebook operations with Srcbook resources.\n- If you're not sure where to start, `orchestration_suggest` can recommend a sequence of operations.\n\nFor a complete list of operations and their parameters, refer to the operations guide available as a resource at `guide://clear-thought-operations`.\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-onepointfive):\n\n```bash\nnpx -y @smithery/cli install @waldzellai/clear-thought-onepointfive --client claude\n```\n\n### Manual Installation\n```bash\nnpm install @waldzellai/clear-thought-onepointfive\n```\n\nOr run with npx:\n\n```bash\nnpx @waldzellai/clear-thought-onepointfive\n```\n\n### Development Setup\n```bash\ngit clone <repository-url>\ncd clearthought-onepointfive\nnpm install\nnpx @smithery/cli dev\n```\n\n## Usage\n\nAll operations are accessed through the `clear_thought` tool. You specify the desired operation using the `operation` parameter.\n\n### Example: Sequential Thinking\n```typescript\nconst response = await mcp.callTool(\"clear_thought\", {\n  operation: \"sequential_thinking\",\n  prompt: \"How to implement a new feature?\",\n  parameters: {\n    pattern: \"chain\"\n  }\n});\n```\n\n### Example: Mental Model\n```typescript\nconst response = await mcp.callTool(\"clear_thought\", {\n  operation: \"mental_model\",\n  prompt: \"Analyze the trade-offs of using a microservices architecture.\",\n  parameters: {\n    model: \"first_principles\"\n  }\n});\n```\n\n### Example: Ulysses Protocol (High-Stakes Debugging)\n```typescript\nconst response = await mcp.callTool(\"clear_thought\", {\n  operation: \"ulysses_protocol\",\n  prompt: \"Fix critical authentication failure in production system\",\n  parameters: {\n    stakes: \"critical\",\n    budget: \"4 hours\"\n  }\n});\n```\n\n### Example: Notebook Operations\n```typescript\n// Create a new notebook\nconst createResponse = await mcp.callTool(\"clear_thought\", {\n  operation: \"notebook_create\",\n  prompt: \"Create a notebook for learning TypeScript\",\n  parameters: {\n    name: \"typescript-learning\"\n  }\n});\n\n// Add a cell to the notebook\nconst addCellResponse = await mcp.callTool(\"clear_thought\", {\n  operation: \"notebook_add_cell\",\n  prompt: \"Add a code cell demonstrating TypeScript interfaces\",\n  parameters: {\n    notebookId: \"typescript-learning\",\n    cellType: \"code\",\n    content: \"interface User { name: string; age: number; }\"\n  }\n});\n```\n\n### Example: Statistical Reasoning\n```typescript\nconst response = await mcp.callTool(\"clear_thought\", {\n  operation: \"statistical_reasoning\",\n  prompt: \"Analyze the performance data of our API endpoints\",\n  parameters: {\n    mode: \"summary\",\n    data: [/* your data here */]\n  }\n});\n```\n\n## Resources\n\nThe server provides several resources for enhanced functionality:\n\n### Operations Guide\n- **URI**: `guide://clear-thought-operations`\n- **Description**: Complete documentation for all operations and their parameters\n- **MIME Type**: `text/markdown`\n\n### Interactive Notebooks\n- **URI Template**: `notebook:///{name}`\n- **Description**: Access Srcbook notebooks for interactive TypeScript/JavaScript execution\n- **MIME Type**: `text/markdown`\n\n### Notebook Interaction Guide\n- **URI**: `guide://notebook-interaction`\n- **Description**: Instructions for working with Srcbook notebooks in MCP\n- **MIME Type**: `text/markdown`\n\n## Docker\n\nBuild the Docker image:\n\n```bash\ndocker build -t waldzellai/clear-thought-onepointfive .\n```\n\nRun the container:\n\n```bash\ndocker run -it waldzellai/clear-thought-onepointfive\n```\n\n## Development\n\n1. Clone the repository\n2. Install dependencies: `npm install`\n3. Dev server (single entry via CLI): `npx @smithery/cli dev`\n4. Build for deployment: `npx @smithery/cli build`\n\n### Available Scripts\n- `npm run build:stdio` - Build STDIO server\n- `npm run build:http` - Build HTTP server\n- `npm run build` - Build both servers\n- `npm run dev` - Start development server\n- `npm run typecheck` - TypeScript type checking\n- `npm run check` - Biome linting and formatting\n- `npm run test` - Run tests with Vitest\n\n### Architecture\n\nThe codebase follows a modular architecture:\n\n```\nsrc/tools/\n├── operations/           # All operations organized by category\n│   ├── core/            # Core thinking operations (7)\n│   ├── session/         # Session management (3)\n│   ├── collaborative/   # Collaborative reasoning (5)\n│   ├── analysis/        # Analysis operations (7)\n│   ├── patterns/        # Reasoning patterns (5)\n│   ├── ui/              # UI operations (2)\n│   ├── notebook/        # Notebook operations (4)\n│   ├── metagame/        # Advanced frameworks (2)\n│   └── special/         # Special operations (3)\n├── helpers/             # Helper utilities\n│   └── ui-generation.ts # UI generation helpers\n└── index.ts             # Main orchestrator\n```\n\nEach operation:\n- Extends `BaseOperation` class\n- Implements the `Operation` interface\n- Is self-contained (~100-150 lines)\n- Auto-registers on import\n- Has consistent error handling\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## Key Features\n\n### 🧠 **Unified Reasoning Tool**\nSingle `clear_thought` tool with 30+ operations covering all aspects of systematic thinking and problem-solving.\n\n### 📓 **Interactive Notebooks**\nSrcbook notebook integration for interactive TypeScript/JavaScript execution and learning.\n\n### 🎯 **Metagame Operations**\nAdvanced frameworks like Ulysses Protocol and OODA Loop for high-stakes problem-solving.\n\n### 📊 **Statistical Analysis**\nMultiple statistical reasoning modes including Bayesian analysis, hypothesis testing, and Monte Carlo simulation.\n\n### 🔄 **Session Management**\nPersistent session state with export/import capabilities for long-running reasoning tasks.\n\n### 🛡️ **Code Execution**\nSecure Python code execution in restricted environments.\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- Ulysses Protocol inspired by systematic debugging and problem-solving methodologies\n- OODA Loop implementation based on John Boyd's military strategy framework\n","readmeFilename":"README.md"}