ThoughtMCP

Production-Ready AI Cognitive Architecture with Human-Like Memory and Reasoning

ThoughtMCP provides AI systems with persistent memory, parallel reasoning, and metacognitive capabilities through the Model Context Protocol (MCP).

Key Features

• Five-Sector Memory: Episodic, Semantic, Procedural, Emotional, and Reflective memory types
• Web UI: Visual interface for memory exploration and reasoning (⚠️ Beta)
• Parallel Reasoning: Four concurrent streams (Analytical, Creative, Critical, Synthetic)
• Framework Selection: Eight systematic thinking frameworks with >80% selection accuracy
• Metacognition: Confidence calibration, bias detection, emotion analysis
• Production Ready: 75%+ test coverage, sub-200ms retrieval, PostgreSQL persistence

Quick Start

# Clone and install
git clone https://github.com/keyurgolani/ThoughtMcp.git
cd ThoughtMcp
npm install

# Setup environment
cp .env.example .env
docker-compose up -d
npm run db:setup

# Build and start
npm run build
npm start

MCP Tools

| Category | Tools | Description | | ----------------- | ---------------------------------------------------------------- | --------------------------------- | | Memory | remember, recall, update_memory, forget, search | Persistent five-sector memory | | Reasoning | think, analyze, ponder, breakdown | Multi-stream reasoning | | Metacognitive | assess_confidence, detect_bias, detect_emotion, evaluate | Self-monitoring and quality check |

MCP Configuration

{
  "mcpServers": {
    "thoughtmcp": {
      "command": "node",
      "args": ["/path/to/ThoughtMcp/dist/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/thoughtmcp",
        "OLLAMA_HOST": "http://localhost:11434"
      }
    }
  }
}

Web UI (Beta)

ThoughtMCP includes a web-based interface for visualizing memories and reasoning processes. The UI is currently in beta and under active development.

# Start the UI development server
cd ui
npm install
npm run dev

⚠️ Beta Notice: The UI is experimental and may have breaking changes between releases. Not recommended for production use yet.

Documentation

| Guide | Description | | ------------------------------------ | ------------------------------- | | User Guide | Getting started and basic usage | | MCP Tools | Tool schemas and examples | | Architecture | System design | | Development | Development workflow | | Deployment | Production deployment |

See docs/ for complete documentation.

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details