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
Glass Box Observability: Real-time visualization of internal reasoning streams (Thought Console)
Cognitive Personalization: Configurable skepticism levels and thinking styles via User Profile
Visual Intelligence: 3D memory graph with Semantic Zooming and Level-of-Detail (LOD)
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

ThoughtMcp