@waldzellai/clear-thought

Clear Thought MCP Server

A Model Context Protocol (MCP) server that provides systematic thinking, mental models, and debugging approaches for enhanced problem-solving capabilities.

Features

Mental Models

• First Principles Thinking
• Opportunity Cost Analysis
• Error Propagation Understanding
• Rubber Duck Debugging
• Pareto Principle
• Occam's Razor
• And many more...

Design Patterns

• Modular Architecture
• API Integration Patterns
• State Management
• Asynchronous Processing
• Scalability Considerations
• Security Best Practices
• Agentic Design Patterns

Note: Compatible with various modern web frameworks and architectures.

Programming Paradigms

• Imperative Programming
• Procedural Programming
• Object-Oriented Programming
• Functional Programming
• Declarative Programming
• Logic Programming
• Event-Driven Programming
• Aspect-Oriented Programming
• Concurrent Programming
• Reactive Programming

Debugging Approaches

• Binary Search
• Reverse Engineering
• Divide and Conquer
• Backtracking
• Cause Elimination
• Program Slicing
• Advanced debugging patterns

Sequential Thinking

• Structured thought process
• Revision and branching support
• Progress tracking
• Context maintenance

Tool Selection Guide

Each tool in the Clear Thought MCP Server has specific strengths. Here are some scenarios where each tool might be particularly useful:

Mental Models

Best suited for:

• Initial problem understanding
• Breaking down complex systems
• Analyzing trade-offs
• Finding root causes
• Making strategic decisions

Example scenarios:

• Analyzing system architecture choices
• Evaluating competing solutions
• Understanding error patterns

Design Patterns

Best suited for:

• Implementing proven solutions
• Structuring new features
• Ensuring maintainable code
• Scaling applications
• Managing technical debt

Example scenarios:

• Building new system components
• Refactoring existing code
• Implementing cross-cutting concerns

Debugging Approaches

Best suited for:

• Troubleshooting issues
• Performance optimization
• System analysis
• Error resolution
• Quality assurance

Example scenarios:

• Fixing production issues
• Optimizing slow processes
• Resolving integration problems

Sequential Thinking

Best suited for:

• Complex problem-solving
• Multi-step analysis
• Decision refinement
• Process improvement
• Comprehensive planning

Example scenarios:

• Planning major features
• Analyzing system-wide changes
• Making architectural decisions

Note: These are suggestions rather than rules. Tools can be used in any order or combination that best serves your needs.

Installation

Installing via Smithery

To install Clear Thought MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @waldzellai/clear-thought --client claude

Manual Installation

npm install @waldzellai/clear-thought

Or run with npx:

npx @waldzellai/clear-thought

Usage

Mental Models

const response = await mcp.callTool("mentalmodel", {
  modelName: "first_principles",
  problem: "How to implement a new feature?",
  steps: [
    "Break down the problem",
    "Analyze components",
    "Build solution"
  ]
});

Debugging Approaches

const response = await mcp.callTool("debuggingapproach", {
  approachName: "binary_search",
  issue: "Performance degradation in the system",
  steps: [
    "Identify performance metrics",
    "Locate bottleneck",
    "Implement solution"
  ]
});

Sequential Thinking

const response = await mcp.callTool("sequentialthinking", {
  thought: "Initial analysis of the problem",
  thoughtNumber: 1,
  totalThoughts: 3,
  nextThoughtNeeded: true
});

Docker

Build the Docker image:

docker build -t waldzellai/clear-thought .

Run the container:

docker run -it waldzellai/clear-thought

Development

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Start the server: npm start

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.

Acknowledgments

• Based on the Model Context Protocol (MCP) by Anthropic, and uses the code for the sequentialthinking server
• Mental Models framework inspired by James Clear's comprehensive guide to mental models, which provides an excellent overview of how these thinking tools can enhance decision-making and problem-solving capabilities