Unified Thinking Server

A Model Context Protocol (MCP) server that consolidates multiple cognitive thinking patterns into a single Go-based implementation with 85 specialized reasoning tools.

Quick Start

git clone https://github.com/quanticsoul4772/unified-thinking.git
cd unified-thinking
make build
# Configure Claude Desktop (see Installation section)
# Restart Claude Desktop

Features

Thinking Modes (7)

Mode	Description
Linear	Sequential step-by-step reasoning
Tree	Multi-branch parallel exploration with cross-references
Divergent	Creative ideation with "rebellion" capability
Reflection	Metacognitive analysis of previous reasoning
Backtracking	Checkpoint-based with restore capabilities
Auto	Automatic mode selection based on input
Graph	Graph-of-Thoughts with aggregation, refinement, cyclic reasoning

Tool Categories (85 tools)

Category	Tools	Description
Core Thinking	11	think, history, branches, validation, search
Probabilistic	4	Bayesian inference, evidence assessment
Decision	2	Multi-criteria analysis, problem decomposition
Metacognition	3	Self-evaluation, bias detection, blind spots
Hallucination	5	Verification, calibration tracking
Perspective	4	Stakeholder analysis, temporal reasoning
Causal	5	Causal graphs, interventions, counterfactuals
Integration	6	Cross-mode synthesis, workflow orchestration
Dual-Process	1	System 1/2 reasoning
Backtracking	3	Checkpoints, restoration
Abductive	2	Hypothesis generation and evaluation
Case-Based	2	Similar case retrieval, CBR cycles
Symbolic	2	Theorem proving, constraint checking
Enhanced	8	Analogies, argument analysis, fallacy detection
Episodic Memory	5	Session tracking, pattern learning, recommendations
Knowledge Graph	3	Entity storage, semantic search, relationships
Similarity	1	Semantic thought search
Graph-of-Thoughts	9	GoT operations (generate, aggregate, refine, score, prune, explore)
Claude Code	5	Session export/import, presets, formatting
Research	1	Web-augmented research with citations
Multimodal	1	Image embedding generation
Agentic	2	Autonomous tool-calling agent

See API_REFERENCE.md for complete tool documentation.

Installation

Prerequisites

• Go 1.24+
• Git

Build

macOS/Linux:

git clone https://github.com/quanticsoul4772/unified-thinking.git
cd unified-thinking
make build  # Output: bin/unified-thinking

Windows:

git clone https://github.com/quanticsoul4772/unified-thinking.git
cd unified-thinking
make build  # Output: bin\unified-thinking.exe

Configuration

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Required Configuration

All infrastructure is required - the server fails fast if any required configuration is missing.

{
  "mcpServers": {
    "unified-thinking": {
      "command": "/path/to/bin/unified-thinking",
      "env": {
        "DEBUG": "true",
        "STORAGE_TYPE": "sqlite",
        "SQLITE_PATH": "~/Library/Application Support/Claude/unified-thinking.db",
        "VOYAGE_API_KEY": "your-voyage-api-key",
        "ANTHROPIC_API_KEY": "your-anthropic-api-key",
        "NEO4J_URI": "neo4j+s://your-instance.databases.neo4j.io",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password",
        "NEO4J_DATABASE": "neo4j"
      }
    }
  }
}

Environment Variables

Required (server fails if missing):

Variable	Description
VOYAGE_API_KEY	Voyage AI API key for embeddings
ANTHROPIC_API_KEY	Anthropic API key for GoT, agent, web search
NEO4J_URI	Neo4j connection URI
NEO4J_USERNAME	Neo4j username
NEO4J_PASSWORD	Neo4j password

Storage:

Variable	Default	Description
STORAGE_TYPE	sqlite	sqlite (recommended) or memory
SQLITE_PATH	./data/unified-thinking.db	Database file path

Optional:

Variable	Default	Description
DEBUG	false	Enable debug logging
NEO4J_DATABASE	neo4j	Neo4j database name
EMBEDDINGS_MODEL	voyage-3-lite	Embedding model
GOT_MODEL	claude-sonnet-4-5-20250929	Model for Graph-of-Thoughts

Documentation

• API Reference - Complete tool documentation with parameters and examples
• Configuration Guide - Detailed configuration options
• Embeddings Guide - Semantic embeddings setup
• Changelog - Version history and updates

Development

make build          # Build binary
make test           # Run tests
make test-coverage  # Coverage report
make benchmark      # Run benchmarks
make clean          # Remove artifacts

Test Coverage: 71% overall | 156 test files | 100% pass rate

Package	Coverage
metrics	100%
presets	98%
config	97%
similarity	95%
format	95%
reinforcement, reasoning	90%
analysis, modes, metacognition	87%
memory, orchestration, validation	83%

Troubleshooting

Issue	Solution
Server won't start	Check go version (1.24+), verify binary in bin/
Tools not appearing	Restart Claude Desktop, check config syntax
Data lost on restart	Set STORAGE_TYPE=sqlite
GoT tools fail	Set ANTHROPIC_API_KEY

Contributing

• Contributing Guidelines
• Code of Conduct
• Security Policy

License

MIT License - see LICENSE

Support

• GitHub Issues
• GitHub Discussions

---

Built with the MCP Go SDK