hubinoretros/deep-thinker

Advanced cognitive thinking MCP server with DAG-based thought graph, **10 reasoning strategies** (including auto-selection), **17 tools**, node aliases, session persistence, structured responses, and intelligent error handling.
A significant evolution beyond sequential-thinking MCP, providing structured deep reasoning with graph-based thought management, schema validation, and intelligent strategy selection.
Quick Start
Examples
| Example | Strategy | Use Case |
|---------|----------|----------|
| Architecture Decision | Dialectic + Parallel | Monolith vs microservices |
| Debugging Incident | Abductive | Production 500 errors |
| Feature Prioritization | Parallel + Dialectic | Q3 roadmap planning |
| Scientific Hypothesis | Analogical + Abductive | LNP delivery for CRISPR |
| Breaking Dead Ends | Metacognitive switch | Serverless cost analysis |
Features
- **DAG-Based Thought Graph** — Thoughts form a directed acyclic graph with branching, merging, and cross-edges (not just a linear chain)
- **10 Reasoning Strategies** — Sequential, Dialectic (thesis→antithesis→synthesis), Parallel, Analogical, Abductive, **First Principles** (deconstruct to fundamentals), **Counterfactual** (what-if with ripple effects), **Systems Thinking** (feedback loops & leverage points), **MCTS** (Monte Carlo optimization), **Auto** (intelligent auto-selection based on content and graph state)
- **Node Aliases** — Use "last", "best", "root" instead of cryptic node IDs for any nodeId parameter
- **Structured Responses** — All tool responses return consistent MCPResponse JSON with status, summary, confidence, nextSuggested action
- **Session Persistence** — Auto-saves thought graph to ~/.deep-thinker/sessions/; resume across MCP restarts with reset({ resume: "name" })
- **Friendly Error Messages** — Zod validation errors translated to human-readable hints (e.g., "confidence 0 ile 1 arasında...")
- **Confidence Scoring** — Multi-factor confidence evaluation with support/contradiction analysis, depth penalties, and knowledge integration boosts
- **Self-Critique** — Automatic critique generation with severity levels and confidence adjustments
- **Metacognitive Engine** — Detects stuck states, stagnation, declining confidence; suggests strategy switches and corrective actions
- **Knowledge Integration** — Attach external knowledge to thoughts, detect gaps, validate consistency across sources
- **Thought Pruning** — Dead-end detection, redundancy removal, deep unproductive branch elimination, path optimization
- **help Tool** — Discover all 17 tools grouped by category (core/advanced/workflow) with quick-start examples
- **conclude Tool** — Comprehensive graph summary with primaryFinding, actionItems, graphHealth, and nextSuggested
- **High-IQ Reasoning Enhancements** — 8 advanced tools: visualization, devil's advocate, cross-disciplinary synthesis, temporal projection, ethical evaluation, emotional intelligence analysis, decision explanation, social impact analysis
- **Emotional Intelligence** — Analyze emotional tone, empathy, persuasion effectiveness, stakeholder emotions
- **Ethical Frameworks** — Evaluate through deontological, consequentialist, virtue ethics, rights-based perspectives
- **Cross-Domain Synthesis** — Combine insights from biology, economics, physics, psychology, computer science, art
- **Temporal Reasoning** — Project thoughts into future/past scenarios with optimistic, pessimistic, realistic, disruptive scenarios
- **Social Impact Modeling** — Analyze stakeholder emotions, group cohesion, persuasion effectiveness, ethical alignment
- **Uncertainty Quantification** — Confidence intervals, probability distributions, sensitivity analysis for robust decisions
- **Multi-Language Support** — Thoughts in English, Turkish, German, French, Spanish, Japanese, Chinese, Russian
- **Meta-Cognitive Layers** — Recursive reasoning across 5 levels of meta-cognition
- **PromptOptimizer (Node Zero)** — Entry point that transforms vague prompts into optimized Super Prompts with automatic strategy routing
Installation
Global
npx (no install)
MCP Configuration
Claude Desktop
Add to your claude_desktop_config.json:
Or if installed globally:
Other MCP Clients
The server communicates over stdio. Point your MCP client to the deep-thinker command or node path/to/dist/index.js.