Master Brain MCP Hub

Zentraler MCP Server der alle AI-Tools mit dem Master Brain verbindet. Inklusive Auto-Memory: Wichtige Interaktionen werden automatisch gespeichert.

Version: 1.0.0 Status: In Development

Features

Zentrales Brain - Ein Wissens-Hub für alle AI-Tools
Auto-Memory - Entscheidungen, Fixes, Learnings werden automatisch gespeichert
Multi-Tool Support - Claude Code, Codex, Cursor, API
Haiku-Analyse - Intelligente Filterung was gespeichert wird
24/7 Betrieb - PM2 managed, läuft auf dem Server

Architektur

┌─────────────────────────────────────────────────────────────────────┐
│                     MCP MASTER BRAIN HUB                            │
│  ┌───────────────────────────────────────────────────────────────┐  │
│  │                    AUTO-MEMORY MIDDLEWARE                     │  │
│  │   Request ──▶ [Haiku Analyse] ──▶ Response                   │  │
│  │                      │                                        │  │
│  │               Wichtig? ──▶ [SPEICHERN]                       │  │
│  └───────────────────────────────────────────────────────────────┘  │
│                              │                                      │
│                              ▼                                      │
│  ┌───────────────────────────────────────────────────────────────┐  │
│  │                      MASTER BRAIN                             │  │
│  │              (Vektor-DB, Embeddings, Wissen)                  │  │
│  └───────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────┘
         ▲              ▲              ▲              ▲
    Claude Code    Claude Code      Codex         Cursor
       (Mac)        (Server)

Quick Start

1. Installation

git clone https://github.com/Activi-AI/Master-Brain-MCP-Hub.git
cd Master-Brain-MCP-Hub
npm install
cp .env.example .env
# .env anpassen
npm run build

2. In Claude Code einbinden

// ~/.claude/mcp_servers.json
{
  "master-brain": {
    "type": "stdio",
    "command": "node",
    "args": ["/path/to/master-brain-mcp/dist/index.js"],
    "env": {
      "BRAIN_API_URL": "http://178.156.178.70:3001",
      "ANTHROPIC_API_KEY": "sk-ant-xxxxx"
    }
  }
}

3. Oder Remote via SSH

{
  "master-brain": {
    "type": "stdio",
    "command": "ssh",
    "args": ["root@178.156.178.70", "node", "/root/master-brain-mcp/dist/index.js"]
  }
}

MCP Tools

Tool	Beschreibung
`brain_search`	Durchsucht das Brain (semantic/keyword/hybrid)
`brain_save`	Speichert Wissen manuell
`brain_stats`	Zeigt Brain-Statistiken
`brain_recent`	Zeigt letzte Einträge
`brain_health`	Prüft Brain-Verbindung
`auto_memory_status`	Status der Auto-Memory Middleware
`auto_memory_config`	Konfiguriert Auto-Memory

Auto-Memory

Das System analysiert automatisch alle Interaktionen und speichert wichtige Inhalte:

Typ	Wird erkannt bei
`decision`	"Wir haben uns für X entschieden"
`fix`	"Der Bug war weil..."
`learning`	"Ich habe gelernt dass..."
`pattern`	"So macht man X in diesem Projekt"
`preference`	"User will immer Y"
`config`	"Die Konfiguration ist Z"
`error`	"Fehler: ABC"

Konfiguration

# .env
AUTO_MEMORY_ENABLED=true
AUTO_MEMORY_MIN_CONFIDENCE=0.7  # Nur speichern wenn Confidence >= 70%

Deployment

PM2 (empfohlen)

npm run build
pm2 start ecosystem.config.cjs
pm2 save

Logs

pm2 logs master-brain-mcp

Projekt-Struktur

/
├── README.md                    # Diese Datei
├── MASTER_RUNBOOK.md           # Step-by-Step Entwicklungs-Runbook
├── PROJECT_STATE.md            # Single Source of Truth
├── capabilities.yml            # Capability-Definitionen mit Test-Regeln
├── PRODUCTION_CHECKLIST.md     # Pflicht vor Go-Live
│
├── CONTRACTS/
│   ├── api_contract.md         # API Endpoints (Pflicht)
│   └── data_contract.md        # DB Schema (Pflicht)
│
├── docs/
│   ├── PROJECT_BRIEF.md        # Projekt-Übersicht
│   ├── ARCHITECTURE.md         # System-Architektur
│   ├── TEST_PLAN.md            # Testplan (verweist auf capabilities.yml)
│   └── CONTRACT_VERIFICATION.md # FE ↔ BE ↔ DB Prüfung (Step 7.5)
│
├── ops/
│   ├── POLICY.md               # Projekt-Policies
│   ├── DECISIONS.md            # Architektur-Entscheidungen
│   ├── RISKS.md                # Identifizierte Risiken
│   ├── OPEN_QUESTIONS.md       # Offene Fragen
│   └── RUNBOOK_SUPERVISOR.md   # Supervisor-Checkliste
│
├── agents/                     # AI Agent Definitionen
│   └── {agent_name}/
│       ├── flow.yaml
│       └── playbook.md
│
├── eval/
│   ├── scorecard.yaml          # Bewertungskriterien
│   └── regression_tests.yaml   # Regression Tests
│
├── schemas/
│   └── *.json                  # JSON Schemas für Outputs
│
├── scripts/
│   └── ci/                     # CI/CD Scripts
│
├── integrations/               # Externe Integrationen
│   └── README.md               # Verweis auf zentrale Registry
│
├── templates/
│   └── TASK_TICKET.md          # Task-Vorlage
│
└── .github/
    ├── workflows/
    │   ├── ci.yml
    │   └── quality-gate.yml
    ├── pull_request_template.md
    └── ISSUE_TEMPLATE/

Kernkonzepte

1. Contracts-First

API und DB werden ZUERST definiert. Keine Änderung ohne explizite Genehmigung.

2. Capabilities mit Test-Pflichten

Jede Funktion wird in capabilities.yml registriert mit zugehörigen Test-Anforderungen.

3. Production-Pflichten

Vor Go-Live MUSS PRODUCTION_CHECKLIST.md komplett abgehakt sein.

4. Single Source of Truth

PROJECT_STATE.md ist die einzige Wahrheit über den Projekt-Status.

Regeln

Contracts sind Gesetz - Keine stillen Änderungen
1 Step pro Antwort - Bei AI-Coding
Tests für alles - Keine Funktion ohne Test
Evidence required - Keine Behauptung ohne Beweis