# 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

```bash
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

```json
// ~/.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

```json
{
  "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

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

## Deployment

### PM2 (empfohlen)

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

### Logs

```bash
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