Skip to main content
Glama

handoff-mcp

MCP-Server, der als Shared-Memory-Hub für mehrere LLMs (Claude, Gemini, Copilot, Codex) fungiert. Jeder Agent, der ein Projekt übernimmt, versteht sofort dessen Architektur, Muster und Entscheidungen – und kann genau dort weitermachen, wo das vorherige LLM aufgehört hat.

Tools

Tool

Beschreibung

create_or_get_project

Projekt initialisieren oder abrufen

save_architecture

Architekturübersicht und Tech-Stack speichern

get_project_summary

Vollständige Projektübersicht — perfekt als erster Aufruf

save_context_snapshot

Arbeitsstatus vor der Übergabe speichern

get_context_snapshot

Abrufen, was das vorherige LLM gerade getan hat

list_sessions

Alle gespeicherten Sitzungen auflisten

save_code_pattern

Wiederverwendbare Codemuster speichern (JWT, FCM, etc.)

get_code_patterns

Muster nach Kategorie/Sprache abrufen

save_architectural_decision

Eine ADR speichern (warum eine Entscheidung getroffen wurde)

get_decisions

Architektur-Entscheidungen abrufen

search_context

Über Muster, Entscheidungen und Snapshots hinweg suchen

Related MCP server: Waymark

Installation

Voraussetzungen: Bun

git clone https://github.com/Juan-Severiano/handoff-mcp
cd handoff-mcp
bun install

Konfiguration

Ersetzen Sie /path/to/handoff-mcp durch den absoluten Pfad, unter dem Sie das Repo geklont haben.

Claude Desktop

Datei: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"]
    }
  }
}

Claude Code

claude mcp add handoff-mcp bun /path/to/handoff-mcp/src/index.ts

Gemini CLI

Datei: ~/.gemini/settings.json

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"]
    }
  }
}

GitHub Copilot (VS Code)

Datei: .vscode/mcp.json in Ihrem Workspace oder VS Code Benutzer settings.json:

{
  "servers": {
    "handoff-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"]
    }
  }
}

OpenAI Codex CLI

Datei: ~/.codex/config.yaml

mcpServers:
  handoff-mcp:
    command: bun
    args:
      - /path/to/handoff-mcp/src/index.ts

DB-Pfad (optional)

Standardmäßig wird context.db im Arbeitsverzeichnis erstellt. Überschreiben Sie dies über eine Umgebungsvariable:

{
  "mcpServers": {
    "handoff-mcp": {
      "command": "bun",
      "args": ["/path/to/handoff-mcp/src/index.ts"],
      "env": { "DB_PATH": "/your/shared/path/context.db" }
    }
  }
}

Tipp: Verweisen Sie alle LLMs auf denselben DB_PATH, damit sie sich eine Datenbank über verschiedene Tools hinweg teilen.

Ablauf

Claude works on the project
→ create_or_get_project("my-app")
→ save_architecture({ description: "React Native + Spring Boot" })

Claude runs low on tokens
→ save_context_snapshot({
    llmModel: "claude-opus-4",
    taskDescription: "Implementing push notifications",
    recentChanges: "FCM handler done",
    nextSteps: "Wire up Foreground Service, test Android 16"
  })

Gemini takes over
→ get_project_summary("my-app")      # full context in one call
→ get_context_snapshot("my-app")     # picks up exactly where Claude stopped
→ continues...

Entwicklung

bun run dev      # watch mode
bun run inspect  # MCP Inspector
bun run build    # compile to dist/

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers