Servidor MCP que actúa como un centro de memoria compartida entre múltiples LLM (Claude, Gemini, Copilot, Codex). Cualquier agente que entra en un proyecto comprende inmediatamente su arquitectura, patrones y decisiones, y puede continuar exactamente donde lo dejó el LLM anterior.
Herramienta | Descripción |
| Inicializar o recuperar un proyecto |
| Guardar la visión general de la arquitectura y la pila tecnológica |
| Resumen completo del proyecto: perfecto como primera llamada |
| Guardar el estado de trabajo antes de realizar una transferencia |
| Recuperar lo que estaba haciendo el LLM anterior |
| Listar todas las sesiones guardadas |
| Guardar patrones de código reutilizables (JWT, FCM, etc.) |
| Recuperar patrones por categoría/lenguaje |
| Guardar una ADR (por qué se tomó una decisión) |
| Recuperar decisiones arquitectónicas |
| Buscar entre patrones, decisiones y capturas de estado |
Related MCP server: Waymark
Requisitos: Bun
git clone https://github.com/Juan-Severiano/handoff-mcp
cd handoff-mcp
bun installReemplaza /path/to/handoff-mcp con la ruta absoluta donde clonaste el repositorio.
Archivo: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"handoff-mcp": {
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"]
}
}
}claude mcp add handoff-mcp bun /path/to/handoff-mcp/src/index.tsArchivo: ~/.gemini/settings.json
{
"mcpServers": {
"handoff-mcp": {
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"]
}
}
}Archivo: .vscode/mcp.json en tu espacio de trabajo, o settings.json de usuario de VS Code:
{
"servers": {
"handoff-mcp": {
"type": "stdio",
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"]
}
}
}Archivo: ~/.codex/config.yaml
mcpServers:
handoff-mcp:
command: bun
args:
- /path/to/handoff-mcp/src/index.tsPor defecto, context.db se crea en el directorio de trabajo. Puedes sobrescribirlo mediante una variable de entorno:
{
"mcpServers": {
"handoff-mcp": {
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"],
"env": { "DB_PATH": "/your/shared/path/context.db" }
}
}
}Consejo: apunta todos los LLM a la misma
DB_PATHpara que compartan una única base de datos entre herramientas.
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...bun run dev # watch mode
bun run inspect # MCP Inspector
bun run build # compile to dist/This server cannot be deployed
Shared project memory that keeps teammates and AI agents aligned 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.
Shared memory for coding agents. Stop re-explaining your codebase every session.
