Vibe Board MCP (ve-vibe-board)

Ihr Agent, aber mit Gedächtnis. Ein auf Firestore basierender MCP-Server, der Claude Code (und jedem MCP-fähigen Agenten) persistentes Gedächtnis über Sitzungen hinweg verleiht – Aufgaben, Fortschritte, Entscheidungen und Übergabemotizen, die Kontextkomprimierung und Sitzungsende überdauern.

Begleit-Repo: HuntsDesk/ve-kit – Vibe Coding Framework & persistentes Gedächtnis für Claude Code. ve-kit bündelt diesen MCP-Server, einen RIPER-CAT-Workflow, Review-Gate-Hooks und einen optionalen Docker-Worker.

Teil von Vibe Entrepreneurs – eine Community für alle Vibe-Coder, die echte Arbeit mit KI ausliefern. Sagen Sie Hallo: vibeentrepreneurs.com.

Warum gibt es das?

Kommt Ihnen das bekannt vor?

• Sie haben sechs Tool-Aufrufe für ein Refactoring getätigt. Der Kontext wird komprimiert. Der Agent kommt mit Vibes zurück, aber ohne Plan.

• Sie starten morgen eine neue Sitzung. Er liest dieselben Dateien erneut, stellt dieselben Fragen, entscheidet Dinge neu, die Sie bereits entschieden hatten.

• Sie haben zugesehen, wie er eine perfekte TodoWrite-Checkliste geschrieben hat – dann endete das Gespräch und die Checkliste verschwand damit.

• Sie haben drei Agenten parallel geöffnet. Keiner von ihnen weiß, was die anderen getan haben.

So fühlt sich Zustandslosigkeit in der Praxis an. Der Agent ist für eine Stunde brillant und danach für immer amnesisch.

Vibe Board ist der Ort, an den der Zustand stattdessen geht. Es ist ein gemeinsames Aufgaben- und Sitzungsboard, das außerhalb jedes einzelnen Gesprächs existiert – in Firestore, nicht im Kontext.

• Agenten erstellen Aufgaben während der Planung – sie überdauern die Sitzung

• Fortschritte werden während der Ausführung verfolgt – sichtbar für den nächsten Durchlauf

• Übergabemotizen werden am Ende der Sitzung geschrieben – mit Verweisen auf die genauen Aufgaben, die noch offen sind

• Die nächste Sitzung ruft board_create_session auf, liest die Übergabe und macht dort weiter, wo die letzte aufgehört hat

Was Sie bekommen: einen Agenten, der am Dienstag weiß, was er am Montag getan hat. Kein erneutes Erklären. Keine verlorenen Pläne. Kein TodoWrite-Friedhof.

Kostenlos ausführbar im kostenlosen Tarif von Firebase.

14 MCP-Tools

Vierzehn Tools, eine Aufgabe: Geben Sie dem Agenten einen Ort für den Zustand, der nicht das Gespräch ist.

Installation

1. Klonen + Build

git clone https://github.com/HuntsDesk/ve-vibe-board.git
cd ve-vibe-board
npm install
npm run build

2. Firebase einrichten

Erstellen Sie ein Firebase-Projekt (der kostenlose Tarif funktioniert). Aktivieren Sie Firestore im nativen Modus. Erstellen Sie ein Dienstkonto mit roles/datastore.user und laden Sie den JSON-Schlüssel herunter.

GOOGLE_APPLICATION_CREDENTIALS akzeptiert entweder einen Dateipfad zum JSON-Schlüssel (kanonisch) oder den rohen JSON-Inhalt inline (praktisch für isolierte Umgebungen wie den Browser-MCP-Inspector von Glama, CI-Geheimnisse oder das Inlined-Secret-Muster von Cloud Run).

Erstellen Sie außerdem 2 zusammengesetzte Indizes:

gcloud firestore indexes composite create \
  --project=YOUR_PROJECT_ID \
  --collection-group=sessions \
  --field-config field-path=project_id,order=ascending \
  --field-config field-path=status,order=ascending \
  --field-config field-path=ended_at,order=descending

gcloud firestore indexes composite create \
  --project=YOUR_PROJECT_ID \
  --collection-group=tasks \
  --field-config field-path=project_id,order=ascending \
  --field-config field-path=status,order=ascending

Warten Sie 1-5 Minuten, bis die Indizes erstellt sind.

3. Claude Code konfigurieren

Fügen Sie dies zur .mcp.json Ihres Projekts hinzu:

{
  "mcpServers": {
    "vibe-board": {
      "command": "node",
      "args": ["/absolute/path/to/ve-vibe-board/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/your-key.json"
      }
    }
  }
}

Erlauben Sie die Tools in .claude/settings.local.json:

{
  "permissions": {
    "allow": [
      "mcp__vibe-board__board_get_projects",
      "mcp__vibe-board__board_create_project",
      "mcp__vibe-board__board_update_project",
      "mcp__vibe-board__board_get_tasks",
      "mcp__vibe-board__board_get_task",
      "mcp__vibe-board__board_create_task",
      "mcp__vibe-board__board_update_task",
      "mcp__vibe-board__board_bulk_update_tasks",
      "mcp__vibe-board__board_delete_task",
      "mcp__vibe-board__board_create_session",
      "mcp__vibe-board__board_end_session",
      "mcp__vibe-board__board_get_handoff",
      "mcp__vibe-board__board_log_activity",
      "mcp__vibe-board__board_get_activity"
    ]
  },
  "enabledMcpjsonServers": ["vibe-board"]
}

4. Überprüfen

Starten Sie eine neue Claude Code-Sitzung und rufen Sie board_get_projects auf. Ein leeres Array = Erfolg.

Agenten-Regeln (in CLAUDE.md einfügen)

## Vibe Board

Persistent task tracking across sessions via MCP tools (`board_*`).
**Mandatory for every substantive session.**

### Use board tasks, NOT TodoWrite
TodoWrite is ephemeral — dies when the session ends. Board tasks persist.
When you would reach for TodoWrite to track multi-step work, use
`board_create_task` instead.

### Session lifecycle
1. Call `board_create_session` at session start — returns last session's handoff
2. Create/update board tasks as you work
3. Call `board_end_session` with progress summary + handoff notes before stopping

Das vollständige Regelwerk (proaktive Trigger, Prozess-Gates, Review-Protokoll) finden Sie in HuntsDesk/ve-kit → docs/ve-kit/02-VIBE-BOARD.md.

Lizenz

MIT. Siehe LICENSE.

Verwandtes

• HuntsDesk/ve-kit – vollständiges Vibe Coding Framework, das diesen MCP-Server bündelt

• HuntsDesk/ve-gws – VE Google Workspace MCP (Geschwisterteil in der ve-*-Familie)