handoff-mcp
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 |
| Projekt initialisieren oder abrufen |
| Architekturübersicht und Tech-Stack speichern |
| Vollständige Projektübersicht — perfekt als erster Aufruf |
| Arbeitsstatus vor der Übergabe speichern |
| Abrufen, was das vorherige LLM gerade getan hat |
| Alle gespeicherten Sitzungen auflisten |
| Wiederverwendbare Codemuster speichern (JWT, FCM, etc.) |
| Muster nach Kategorie/Sprache abrufen |
| Eine ADR speichern (warum eine Entscheidung getroffen wurde) |
| Architektur-Entscheidungen abrufen |
| Ü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 installKonfiguration
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.tsGemini 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.tsDB-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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Shared project memory that keeps teammates and AI agents aligned across sessions.
Project memory shared by AI agents: decisions, results, tasks and handoffs across sessions.
Shared project context for AI agents and teams: docs, tasks, and messages that stay current.
Project memory, documentation and controlled secret access for AI coding agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides persistent context synchronization and memory management for AI agents across sessions and projects, including file indexing, bug tracking, spatial navigation, and agent-to-agent handoff coordination.3 npm3MIT
- AlicenseAqualityCmaintenanceShared memory and handoff hub for AI agents, enabling seamless context transfer between sessions with token-budgeted resumes and automatic handoffs.1011 npmMIT
- AlicenseBqualityDmaintenanceProvides persistent local memory for AI coding sessions, enabling agents to save and retrieve project context across different tools and sessions.16MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to maintain persistent project context locally, with source-backed memory and structured handoffs for seamless handover between interchangeable agents.Apache 2.0