Skip to main content
Glama

handoff-mcp

複数のLLM(Claude、Gemini、Copilot、Codex)間で共有メモリハブとして機能するMCPサーバーです。プロジェクトに参加するエージェントは、そのアーキテクチャ、パターン、決定事項を即座に理解し、前のLLMが中断したところから正確に作業を再開できます。

ツール

ツール

説明

create_or_get_project

プロジェクトの初期化または取得

save_architecture

アーキテクチャの概要と技術スタックの保存

get_project_summary

プロジェクト全体の概要(最初の呼び出しに最適)

save_context_snapshot

引き継ぎ前の作業状態の保存

get_context_snapshot

前のLLMが行っていた作業の取得

list_sessions

保存された全セッションのリスト表示

save_code_pattern

再利用可能なコードパターン(JWT、FCMなど)の保存

get_code_patterns

カテゴリ/言語別のパターン取得

save_architectural_decision

ADR(決定理由)の保存

get_decisions

アーキテクチャ決定事項の取得

search_context

パターン、決定事項、スナップショットの横断検索

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.ts

Gemini 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.ts

DBパス (オプション)

デフォルトでは、作業ディレクトリに 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

    Related MCP Servers