How do I use Master Brain MCP Hub?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Master Brain MCP Hub Search for the fix we implemented for the login error" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Master Brain MCP Hub

Master Brain MCP Hub

Features

Architektur

Quick Start

1. Installation

2. In Claude Code einbinden

3. Oder Remote via SSH

MCP Tools

Auto-Memory

Konfiguration

Deployment

PM2 (empfohlen)

Logs

Projekt-Struktur

Kernkonzepte

1. Contracts-First

2. Capabilities mit Test-Pflichten

3. Production-Pflichten

4. Single Source of Truth

Regeln

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API