handoff-mcp
handoff-mcp
여러 LLM(Claude, Gemini, Copilot, Codex) 간의 공유 메모리 허브 역할을 하는 MCP 서버입니다. 프로젝트에 참여하는 모든 에이전트는 즉시 아키텍처, 패턴, 결정 사항을 이해하고 이전 LLM이 중단한 지점부터 정확하게 작업을 이어받을 수 있습니다.
도구
도구 | 설명 |
| 프로젝트 초기화 또는 가져오기 |
| 아키텍처 개요 및 기술 스택 저장 |
| 전체 프로젝트 개요 — 첫 번째 호출로 적합 |
| 핸드오프 전 작업 상태 저장 |
| 이전 LLM이 수행하던 작업 가져오기 |
| 저장된 모든 세션 나열 |
| 재사용 가능한 코드 패턴(JWT, FCM 등) 저장 |
| 카테고리/언어별 패턴 가져오기 |
| ADR(결정 이유) 저장 |
| 아키텍처 결정 사항 가져오기 |
| 패턴, 결정 사항 및 스냅샷 전체 검색 |
Related MCP server: Waymark
설치
요구 사항: Bun
git clone https://github.com/Juan-Severiano/handoff-mcp
cd handoff-mcp
bun install구성
/path/to/handoff-mcp를 저장소를 복제한 절대 경로로 바꾸십시오.
Claude Desktop
파일: ~/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
파일: ~/.gemini/settings.json
{
"mcpServers": {
"handoff-mcp": {
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"]
}
}
}GitHub Copilot (VS Code)
파일: 작업 공간의 .vscode/mcp.json 또는 VS Code 사용자 settings.json:
{
"servers": {
"handoff-mcp": {
"type": "stdio",
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"]
}
}
}OpenAI Codex CLI
파일: ~/.codex/config.yaml
mcpServers:
handoff-mcp:
command: bun
args:
- /path/to/handoff-mcp/src/index.tsDB 경로 (선택 사항)
기본적으로 context.db는 작업 디렉토리에 생성됩니다. 환경 변수를 통해 재정의할 수 있습니다:
{
"mcpServers": {
"handoff-mcp": {
"command": "bun",
"args": ["/path/to/handoff-mcp/src/index.ts"],
"env": { "DB_PATH": "/your/shared/path/context.db" }
}
}
}팁: 모든 LLM이 동일한
DB_PATH를 가리키도록 설정하여 도구 간에 하나의 데이터베이스를 공유하세요.
흐름
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/Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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