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…
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