Mcp Thinking

MCP Thinking 🤖

A powerful Model Context Protocol (MCP) server that enhances Large Language Models (LLMs) with advanced sequential thinking capabilities. Built on the Model Context Protocol standard, this server enables AI agents to perform structured reasoning and execute complex cognitive tasks with high precision.

📑 Table of Contents

• [Overview](#overview)
• [Key Features](#-key-features)
• [Architecture](#️-architecture)
• [System Overview](#system-overview)
• [Session Flow](#session-flow)
• [Thinking Modes Interaction](#thinking-modes-interaction)
• [Quick Start](#-quick-start)
• [Prerequisites](#prerequisites)
• [Installation](#installation)
• [Docker Support](#docker-support)
• [Thinking Modes](#-thinking-modes)
• [Linear Thinking](#linear-thinking)
• [Tree Thinking](#tree-thinking)
• [Dialectical Thinking](#dialectical-thinking)
• [Systematic Thinking](#systematic-thinking)
• [Creative Thinking](#creative-thinking)
• [Analytical Thinking](#analytical-thinking)
• [Metacognitive Thinking](#metacognitive-thinking)
• [Critical Thinking](#critical-thinking)
• [Systemic Thinking](#systemic-thinking)
• [Lateral Thinking](#lateral-thinking)
• [Strategic Thinking](#strategic-thinking)
• [Empathetic Thinking](#empathetic-thinking)
• [Abstract Thinking](#abstract-thinking)
• [Practical Thinking](#practical-thinking)
• [Integrative Thinking](#integrative-thinking)
• [Evolutionary Thinking](#evolutionary-thinking)
• [Convergent Thinking](#convergent-thinking)
• [Divergent Thinking](#divergent-thinking)
• [Reflective Thinking](#reflective-thinking)
• [Session Management](#-session-management)
• [Session Lifecycle](#session-lifecycle)
• [Session Operations](#session-operations)
• [Session Analysis](#session-analysis)
• [Session Export Formats](#session-export-formats)
• [Error Handling](#error-handling)
• [Best Practices](#best-practices)
• [Monitoring and Logging](#-monitoring-and-logging)
• [Log Levels](#log-levels)
• [Log Categories](#log-categories)
• [Example Log Output](#example-log-output)
• [Monitoring Endpoints](#monitoring-endpoints)
• [Security Considerations](#-security-considerations)
• [Session Security](#session-security)
• [Data Protection](#data-protection)
• [Best Practices](#best-practices-1)
• [Performance Optimization](#-performance-optimization)
• [Resource Management](#resource-management)
• [Scaling Considerations](#scaling-considerations)
• [Performance Metrics](#performance-metrics)
• [Troubleshooting Guide](#-troubleshooting-guide)
• [Connection Issues](#connection-issues)
• [Server Issues](#server-issues)
• [Client Issues](#client-issues)
• [API Reference](#-api-reference)
• [Core Endpoints](#core-endpoints)
• [Request Types](#request-types)
• [Response Formats](#response-formats)
• [Use Cases](#-use-cases)
• [Complex Problem Solving](#1-complex-problem-solving)
• [Research and Analysis](#2-research-and-analysis)
• [Decision Making](#3-decision-making)
• [Creative Problem Solving](#4-creative-problem-solving)
• [Multi-Agent Collaboration](#5-multi-agent-collaboration)
• [Learning and Adaptation](#6-learning-and-adaptation)
• [Community and Support](#-community-and-support)
• [Getting Help](#getting-help)
• [Contributing](#contributing)
• [Community Guidelines](#community-guidelines)
• [Project Statistics](#-project-statistics)
• [Keywords](#-keywords)
• [Changelog](#-changelog)
• [Roadmap](#-roadmap)
• [License](#-license)
• [Acknowledgments](#-acknowledgments)

Overview

MCP Thinking Server is a powerful thinking engine built on the Model Context Protocol (MCP) standard. This server implements advanced thinking capabilities through a standardized interface, enabling AI agents to engage in complex cognitive processes.

For detailed information about the MCP standard, please refer to the official MCP specification.

✨ Key Features

• 🤖 Advanced Thinking
• 19 distinct thinking modes
• Tree-structured thoughts
• Metacognitive analysis
• Logical consistency checking

• 🔄 Session Management
• UUID-based identification
• Robust context handling
• Comprehensive export tools
• Multi-session support

• 🔍 Quality & Analysis
• Confidence assessment
• Cognitive bias detection
• Adaptive planning
• Multi-language support

• ⚡ Performance
• Async-first architecture
• Efficient resource management
• Horizontal scaling support
• Optimized session handling

🏗️ Architecture

System Overview

graph TB
    Client[Client Application] -->|SSE Connection| Server[MCP Server]
    Server -->|Process| Thinking[Thinking Engine]
    Thinking -->|Manage| Sessions[Session Manager]
    Thinking -->|Execute| Tools[Tool Executor]
    Thinking -->|Analyze| Metacognition[Metacognitive Analyzer]
    
    subgraph "MCP Server Components"
        Sessions
        Tools
        Metacognition
    end
    
    subgraph "Thinking Modes"
        Linear[Linear Thinking]
        Tree[Tree Thinking]
        Dialectical[Dialectical Thinking]
        Creative[Creative Thinking]
    end
    
    Thinking --> Linear
    Thinking --> Tree
    Thinking --> Dialectical
    Thinking --> Creative

Session Flow

sequenceDiagram
    participant Client
    participant Server
    participant Session
    participant Engine
    
    Client->>Server: Connect (SSE)
    Server->>Session: Create Session
    Session-->>Client: Session ID
    
    loop Thinking Process
        Client->>Server: Send Thought
        Server->>Engine: Process Thought
        Engine->>Session: Update Context
        Session-->>Client: Analysis Result
    end
    
    Client->>Server: Export Session
    Server->>Session: Gather Data
    Session-->>Client: Export Result

Thinking Modes Interaction

graph LR
    Input[Input Thought] --> Mode[Thinking Mode]
    Mode --> Analysis[Analysis]
    Mode --> Synthesis[Synthesis]
    Mode --> Evaluation[Evaluation]
    
    Analysis --> Output[Output Thought]
    Synthesis --> Output
    Evaluation --> Output
    
    subgraph "Thinking Process"
        Mode
        Analysis
        Synthesis
        Evaluation
    end

🚀 Quick Start

Prerequisites

• Python 3.13+
• Git
• pip (Python package manager)

Installation

```bash

Clone the repository

git clone https://github.com/VitalyMalakanov/mcp-thinking.git cd mcp-thinking

Create and activate virtual environment (recommended)

python -m venv venv source venv/bin/activate # Linux/macOS .\venv\Scripts\activate # Windows

Install dependencies

pip install -r requirements.txt

Start the server

python enhancedsequentialthinking_server.py

The server will be available at `http://localhost:8000/sse`

### Docker Support
```bash
# Using Docker
docker-compose up

# Custom port
MCP_SERVER_PORT=8080 docker-compose up

🧠 Thinking Modes

The Enhanced Sequential Thinking Server supports 19 distinct thinking modes, each designed for specific types of cognitive tasks:

Linear Thinking

• Purpose: Sequential, step-by-step reasoning
• Best for:
• Breaking down complex problems into manageable steps
• Following logical sequences
• Building structured arguments
• Characteristics:
• Clear cause-and-effect relationships
• Predictable progression
• Systematic approach
• Example Use:

``python EnhancedThinkingInput( thought="Implementing a new feature requires: 1) Requirements analysis, 2) Design, 3) Development, 4) Testing", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.LINEAR, tags=["process", "implementation"] ) ``

Tree Thinking

• Purpose: Exploring multiple branches of thought
• Best for:
• Exploring alternatives
• Decision tree analysis
• Complex problem decomposition
• Characteristics:
• Branching exploration
• Multiple paths
• Hierarchical structure
• Example Use:

``python EnhancedThinkingInput( thought="Exploring different approaches to market entry: direct sales, partnerships, acquisitions", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.TREE, tags=["strategy", "exploration"] ) ``

Dialectical Thinking

• Purpose: Resolving contradictions through synthesis
• Best for:
• Resolving conflicts
• Finding common ground
• Developing comprehensive solutions
• Characteristics:
• Thesis-antithesis-synthesis
• Conflict resolution
• Integration of opposites
• Example Use:

``python EnhancedThinkingInput( thought="Analyzing opposing views on remote work: productivity vs. collaboration, finding optimal balance", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.DIALECTICAL, tags=["conflict", "resolution"] ) ``

Systematic Thinking

• Purpose: Methodical component-based analysis
• Best for:
• Complex system analysis
• Process optimization
• Quality improvement
• Characteristics:
• Component-based analysis
• Methodical approach
• Systematic evaluation
• Example Use:

``python EnhancedThinkingInput( thought="Analyzing software architecture components: frontend, backend, database, and their interactions", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.SYSTEMATIC, tags=["architecture", "analysis"] ) ``

Creative Thinking

• Purpose: Generating novel ideas and solutions
• Best for:
• Brainstorming sessions
• Innovation challenges
• Problem-solving with multiple solutions
• Characteristics:
• Divergent idea generation
• Pattern breaking
• Novel connections
• Example Use:

``python EnhancedThinkingInput( thought="Exploring unconventional approaches to renewable energy storage using biomimicry principles", thought_type=ThoughtType.HYPOTHESIS, strategy=ThinkingStrategy.CREATIVE, tags=["innovation", "biomimicry"] ) ``

Analytical Thinking

• Purpose: Strict logical analysis and reasoning
• Best for:
• Data analysis
• Scientific research
• Technical problem-solving
• Characteristics:
• Deductive reasoning
• Inductive reasoning
• Evidence-based conclusions
• Example Use:

``python EnhancedThinkingInput( thought="Analyzing market data trends: correlation analysis, statistical significance, predictive modeling", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.ANALYTICAL, tags=["data", "analysis"] ) ``

Metacognitive Thinking

• Purpose: Self-analysis of thinking processes
• Best for:
• Process improvement
• Learning optimization
• Strategy refinement
• Characteristics:
• Self-reflection
• Process awareness
• Strategy evaluation
• Example Use:

``python EnhancedThinkingInput( thought="Reflecting on problem-solving approach: effectiveness, biases, and potential improvements", thought_type=ThoughtType.METACOGNITION, strategy=ThinkingStrategy.METACOGNITIVE, tags=["reflection", "improvement"] ) ``

Critical Thinking

• Purpose: Analytical evaluation and assessment
• Best for:
• Evaluating arguments and evidence
• Identifying logical fallacies
• Making informed decisions
• Characteristics:
• Evidence-based reasoning
• Systematic evaluation
• Bias awareness
• Example Use:

``python EnhancedThinkingInput( thought="Analyzing the validity of market research data: sample size, methodology, potential biases", thought_type=ThoughtType.EVALUATION, strategy=ThinkingStrategy.CRITICAL, tags=["analysis", "validation"] ) ``

Systemic Thinking

• Purpose: Understanding complex systems and their interactions
• Best for:
• System analysis
• Understanding interdependencies
• Holistic problem-solving
• Characteristics:
• Systems perspective
• Interconnection awareness
• Emergent behavior analysis
• Example Use:

``python EnhancedThinkingInput( thought="Analyzing the impact of climate change on global supply chains: direct effects, feedback loops, and systemic risks", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.SYSTEMIC, tags=["systems", "climate"] ) ``

Lateral Thinking

• Purpose: Finding unconventional solutions
• Best for:
• Creative problem-solving
• Breaking mental blocks
• Finding innovative solutions
• Characteristics:
• Non-linear approach
• Pattern breaking
• Unconventional connections
• Example Use:

``python EnhancedThinkingInput( thought="Exploring unexpected applications of blockchain technology in healthcare data management", thought_type=ThoughtType.HYPOTHESIS, strategy=ThinkingStrategy.LATERAL, tags=["innovation", "blockchain"] ) ``

Strategic Thinking

• Purpose: Long-term planning and goal-oriented reasoning
• Best for:
• Strategic planning
• Resource allocation
• Risk assessment
• Characteristics:
• Goal-oriented analysis
• Resource optimization
• Future-focused planning
• Example Use:

``python EnhancedThinkingInput( thought="Developing a 5-year technology roadmap considering market trends, resource constraints, and competitive landscape", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.STRATEGIC, tags=["planning", "roadmap"] ) ``

Empathetic Thinking

• Purpose: Understanding others' perspectives
• Best for:
• User experience design
• Conflict resolution
• Team collaboration
• Characteristics:
• Perspective-taking
• Emotional awareness
• User-centered focus
• Example Use:

``python EnhancedThinkingInput( thought="Analyzing user feedback to understand pain points in the current interface design", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.EMPATHETIC, tags=["ux", "feedback"] ) ``

Abstract Thinking

• Purpose: Working with models and generalizations
• Best for:
• Theoretical analysis
• Model development
• Pattern recognition
• Characteristics:
• Conceptual modeling
• Pattern abstraction
• Theoretical framework development
• Example Use:

``python EnhancedThinkingInput( thought="Developing a theoretical framework for understanding complex adaptive systems in organizations", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.ABSTRACT, tags=["theory", "modeling"] ) ``

Practical Thinking

• Purpose: Focusing on implementation and results
• Best for:
• Project execution
• Resource management
• Solution implementation
• Characteristics:
• Action-oriented
• Resource-aware
• Results-focused
• Example Use:

``python EnhancedThinkingInput( thought="Planning the implementation of a new feature: resource allocation, timeline, and deliverables", thought_type=ThoughtType.ANALYSIS, strategy=ThinkingStrategy.PRACTICAL, tags=["implementation", "planning"] ) ``

Integrative Thinking

• Purpose: Synthesizing different viewpoints
• Best for:
• Complex problem-solving
• Multi-stakeholder analysis
• Holistic decision-making
• Characteristics:
• Viewpoint synthesis
• Holistic integration
• Multi-perspective analysis
• Example Use:

```python EnhancedThinkingInput( thought="Integrating technical, business, and user perspectives in product development strategy", thought_type=ThoughtType.SYNTHESIS, strategy=ThinkingStrategy.INTEGRATIVE, tags=["integration", "strategy"] )

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: VitalyMalakanov
• Source: VitalyMalakanov/mcp-thinking
• License: MIT

Install and usage instructions live in the source repository linked above.