thoughtmcp

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