MCP Style Agent Collection 🧠

A collection of local MCP-style agents for cognitive enhancement, deep thinking, and systematic reasoning.

Overview

This project implements multiple specialized MCP (Model Context Protocol) agents that work together to enhance human cognitive capabilities:

🧠 Deep Thinking Engine

A comprehensive framework for breaking cognitive limitations through:

• Problem Decomposition: Break complex questions into manageable sub-problems

• Evidence Gathering: Leverage LLM web search for multi-source evidence collection

• Multi-Agent Debate: Organize structured debates from multiple perspectives

• Critical Evaluation: Apply Paul-Elder standards for rigorous thinking assessment

• Bias Detection: Identify and mitigate cognitive biases systematically

• Innovation Methods: Use SCAMPER/TRIZ for breakthrough thinking

• Socratic Reflection: Guide metacognitive awareness and self-assessment

Related MCP server: Clear Thought 1.5

Project Structure

mcp-style-agent/
├── .kiro/                     # Kiro IDE specs and configurations
│   └── specs/                 # Feature specifications
├── src/                       # Source code
│   └── mcps/                  # MCP collection
│       ├── deep_thinking/     # Deep thinking engine
│       └── shared/            # Shared utilities
├── tests/                     # Test suites
└── docs/                      # Documentation

Key Features

• 🔒 Privacy-First: Core reasoning runs locally, only search queries sent externally

• 🔧 Pluggable Architecture: YAML-configurable thinking flows and custom agents

• 📊 Transparent Process: Complete thinking traces with visualization

• 🎯 Scientific Methods: Based on cognitive science and learning research

• ⚡ Optimized Performance: Intelligent caching and async processing

• 🏗️ Modular Design: Shared components across multiple MCP agents

Quick Start

# Install with uv
uv sync

# Initialize the system
uv run deep-thinking init

# Start a thinking session
uv run deep-thinking think "How can we solve climate change effectively?"

MCP Server Deployment

The Deep Thinking Engine can be deployed as an MCP server for integration with MCP-compatible hosts like Cursor and Claude Desktop.

Using uvx (Recommended)

{
  "mcpServers": {
    "deep-thinking-engine": {
      "command": "uvx",
      "args": ["--from", "/path/to/mcp-style-agent", "deep-thinking-mcp-server"],
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Test Deployment

# Test uvx deployment
make test-uvx

# Start MCP server locally
make mcp-server

# Validate configuration
make mcp-server-validate

For detailed deployment instructions, see docs/deployment/README.md.

Development

# Setup development environment
uv sync --dev

# Run tests
uv run pytest

# Format code
uv run black .
uv run isort .

Architecture

The system uses a multi-agent architecture with specialized roles:

• Decomposer Agent: Question analysis and breakdown

• Evidence Seeker: Multi-source information gathering

• Debate Orchestrator: Structured multi-perspective analysis

• Critic Agent: Paul-Elder standards evaluation

• Bias Buster: Cognitive bias detection and mitigation

• Innovator Agent: SCAMPER/TRIZ creative thinking

• Reflector Agent: Socratic questioning and metacognition

License

MIT License - see LICENSE file for details.