@waldzellai/clear-thought v0.0.2

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

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