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) — plus a web UI for exploring memories and reasoning.

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

Related MCP server: Brain-MCP

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

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 (from the repo root)
pnpm install
pnpm dev:ui   # or: cd packages/ui && pnpm dev

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

Documentation

See docs/ for complete documentation.

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details