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