Hosted on GitHub for version control, collaboration, and distribution
Built on Node.js runtime to provide cross-platform compatibility and efficient execution
Uses npm for package management and script execution
Implements the server using TypeScript for type safety and modern JavaScript features
Incorporates Zod for runtime data validation and type checking
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
Design Patterns
Modular Architecture
API Integration Patterns
State Management
Asynchronous Processing
Scalability Considerations
Security Best Practices
Agentic Design Patterns
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
Sequential Thinking
Structured thought process
Revision and branching support
Progress tracking
Context maintenance
Collaborative Reasoning
Multi-persona problem-solving
Diverse expertise integration
Structured debate and consensus building
Perspective synthesis
Decision Framework
Structured decision analysis
Multiple evaluation methodologies
Criteria weighting
Risk and uncertainty handling
Metacognitive Monitoring
Knowledge boundary assessment
Claim certainty evaluation
Reasoning bias detection
Confidence calibration
Uncertainty identification
Scientific Method
Structured hypothesis testing
Variable identification
Prediction formulation
Experimental design
Evidence evaluation
Structured Argumentation
Formal dialectical reasoning
Thesis-antithesis-synthesis
Argument strength analysis
Premise evaluation
Logical structure mapping
Visual Reasoning
Diagrammatic representation
Visual problem-solving
Spatial relationship analysis
Conceptual mapping
Visual insight generation
Prerequisites
Node.js 18.x or higher
npm 9.x or higher
Installation
Installing via Smithery
To install clear-thought-mcp-server for Claude Desktop automatically via Smithery:
Clone the repository:
Then navigate to the project directory:
Install dependencies:
Build the project:
Usage
Running the Server
Start the server with:
This will start the MCP server using stdio transport, which can be connected to by MCP clients.
Development Mode
For development with automatic reloading:
Using with MCP Clients
The server can be used with any MCP-compatible client. Here are some examples:
Using with the MCP Inspector
Install the MCP Inspector:
Run the server:
In another terminal, connect the inspector:
Using with LLM Applications
The server can be integrated with LLM applications that support the Model Context Protocol. Refer to the MCP documentation for specific integration details.
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
Programming Paradigms
Best suited for:
Selecting appropriate coding approaches
Understanding language strengths
Optimizing for specific problem types
Balancing trade-offs in implementation
Example scenarios:
Choosing between OOP and functional approaches
Implementing concurrent systems
Designing reactive applications
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
Collaborative Reasoning
Best suited for:
Complex, multi-faceted problems
Situations requiring diverse expertise
Controversial or high-stakes decisions
Innovation and ideation
Example scenarios:
Architectural design decisions
Product strategy development
Risk assessment and mitigation
Decision Framework
Best suited for:
Structured choice between alternatives
Risk-aware decision making
Multi-criteria evaluation
Stakeholder-sensitive decisions
Example scenarios:
Technology selection
Resource allocation
Strategic planning
Metacognitive Monitoring
Best suited for:
Assessing knowledge boundaries
Evaluating claim certainty
Detecting reasoning biases
Calibrating confidence
Identifying areas of uncertainty
Example scenarios:
Evaluating expertise in unfamiliar domains
Assessing confidence in predictions
Identifying potential biases in analysis
Determining when to seek additional information
Scientific Method
Best suited for:
Systematic hypothesis testing
Empirical investigation
Causal analysis
Evidence-based reasoning
Iterative refinement of understanding
Example scenarios:
Investigating system behavior
Testing causal relationships
Evaluating competing explanations
Designing controlled experiments
Structured Argumentation
Best suited for:
Formal dialectical reasoning
Analyzing complex debates
Evaluating competing positions
Synthesizing diverse viewpoints
Constructing logical arguments
Example scenarios:
Evaluating the strength of arguments
Identifying logical fallacies
Constructing persuasive cases
Resolving conflicting perspectives
Visual Reasoning
Best suited for:
Spatial problem-solving
Conceptual mapping
Pattern recognition
Relationship visualization
Complex system modeling
Example scenarios:
Diagramming system architecture
Visualizing data relationships
Mapping conceptual spaces
Creating visual explanations
Note: These are suggestions rather than rules. Tools can be used in any order or combination that best serves your needs.
Project Structure
Tech Stack
TypeScript
Node.js
Model Context Protocol SDK
Zod (for validation)
Author
Chirag Singhal (@chirag127)
License
MIT
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Provide systematic thinking, mental models, and debugging approaches to enhance problem-solving capabilities. Enable structured reasoning and decision-making support for complex problems. Facilitate integration with MCP-compatible clients for advanced cognitive workflows.
Related MCP Servers
- AsecurityAlicenseAqualityThis server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.Last updated -716MIT License
- AsecurityFlicenseAqualityProvides a standardized way to integrate Perplexity AI's features like chat, search, and documentation access into MCP-based systems.Last updated -1
- AsecurityAlicenseAqualityAn MCP tool enabling structured thinking and analysis across multiple AI platforms through branch management, semantic analysis, and cognitive enhancement.Last updated -117MIT License
- AsecurityFlicenseAqualityAn MCP server implementing the Unified Cognitive Processing Framework for advanced problem-solving, creative thinking, and cognitive analysis through structured tools for knowledge mapping, recursive questioning, and perspective generation.Last updated -312