claude-bridge-mcp

claude-code-bridge-mcp

Claude Code のセッション出力を Claude Chat に直接渡す MCP サーバーです。ツール間でコピー＆ペーストする必要はもうありません。

claude-code-bridge-mcp は、~/.claude/projects/<project-hash>/ にある Claude Code のローカルセッションログを読み取り、MCP 対応クライアント（Claude Desktop、Claude Chat、Cursor など）にツールとして公開する Model Context Protocol（MCP）サーバーです。ターミナルで Claude Code を実行し、1 回のツール呼び出しで最新の出力を Claude Chat に取り込めます。

機能

• get_latest_output — 任意の Claude Code セッション、または最新のセッションから、最も新しいアシスタントメッセージを取得します。
• list_sessions — プロジェクトパス、メッセージ数、タイムスタンプとともに、すべてのローカルセッションを一覧表示します。
• get_session_context — コンテキストに取り込むため、セッションの直近 N 件のメッセージを取得します。
• watch_session — 2 秒ごとにセッションファイルを確認し、要求に応じて新しいメッセージを取得します。
• write_context (v2) — 直近 N 件のメッセージを、整形された Markdown として ~/.claude/bridge-context.md と ~/Documents/claude-bridge-context.md に保存します。
• start_auto_sync (v2) — Markdown のスナップショットを常に最新の状態に保ちます。両方のファイルを 30 秒ごと（設定可能）に書き換えるため、手動で呼び出さなくても同期フォルダーを最新の状態に保てます。
• setup_drive_sync (v2.1) — Google Drive への直接アップロードを許可します。以降、同期のたびに Drive API を介して claude-bridge-context という名前の Google ドキュメントをアップサートします。Drive デスクトップクライアントは不要です。
• send_to_session (v2.2) — ~/.claude/bridge-inbox/<session_id>.txt にある協調型インボックスを介して、特定の Claude Code セッションにプロンプトをキューイングします。読み取り専用の制約を解消し、Projects Claude → インボックス → Claude Code が処理、という流れを実現します。

v2.2 の新機能 — send_to_session（協調型ディスパッチ）

v1 ではセッションを読み取っていました。v2 ではコンテキストを Drive に書き出しました。v2.2 では、相手側からプロンプトを送れるようになりました。

send_to_session は、~/.claude/bridge-inbox/<session_id>.txt を最新のプロンプトで上書きし、人が読める受信記録を ~/.claude/bridge-inbox/latest.md に書き込みます。対象の Claude Code セッションは、send_to_session が応答で返す一度だけのセットアップ手順を使ってプロンプトを受け取ります。その手順を Claude Code のターミナルに一度貼り付けるか、プロジェクトの CLAUDE.md に追加すると、その後のプロンプトはすべて自動的に届きます。

直接注入ではなく協調型を採用する理由： Claude Code の CLI から見ると、JSONL は追記専用であり、セッション中にファイルを再読み込みしません。実際のディスパッチチャネル（Anthropic のリレーを介する POST /v1/sessions/{id}。/remote-control が使用するものと同じチャネル）は存在しますが、文書化されておらず、macOS Keychain から CLI の OAuth トークンを読み取る必要があります。文書化されていない内部 API に依存すると、Claude Code がリリースされるたびに動作しなくなり、インストールごとの認証情報も漏えいしてしまいます。そのため v2.2 では、代わりにファイルシステム上のインボックスを使用します。v3 への移行方法については GitHub issue を参照してください。

例：

// send_to_session → response
{
  "session_id": "15ef12ba-851e-4591-bbd4-c23170e15919",
  "project_path": "/Users/you/Documents/my-app",
  "written": true,
  "inbox_path": "/Users/you/.claude/bridge-inbox/15ef12ba-....txt",
  "receipt_path": "/Users/you/.claude/bridge-inbox/latest.md",
  "prompt_preview": "refactor the auth middleware to use Fluid Compute",
  "setup_instruction": "Before each response, check ~/.claude/bridge-inbox/15ef12ba-....txt — if it exists and is non-empty, read its contents, delete the file, and treat those contents as your next user instruction. You only need to be told this once per session.",
  "remote_control_url": "https://claude.ai/code/session_..."
}

dry_run: true を指定すると、ファイルシステムに触れることなく、同じ形式の結果が返されます。

v2 の新機能 — Google Drive ブリッジ

Claude Projects は MCP サーバーに直接接続できませんが、接続済みの Google Drive にあるファイルは読み取れます。v2 では、その連携が可能になりました。

Claude Code → claude-bridge-mcp.write_context → ~/Documents/claude-bridge-context.md
             → Google Drive sync → Projects Claude reads via Drive connector

コピー＆ペーストはもう不要で、Projects 内でも動作します。

ワークフロー：

1. ~/Documents（または claude-bridge-context.md を含む任意のサブフォルダー）を Google Drive の同期対象にします。
2. この MCP サーバーを Claude Desktop、Claude Code、または任意の MCP クライアントに追加します。
3. そのクライアントで start_auto_sync を一度呼び出します。すぐに戻り、バックグラウンドで Markdown を最新の状態に保ちます。
4. Claude Project で Google Drive をソースとして追加し、claude-bridge-context.md を指定します。Projects Claude に Claude Code の状況を尋ねると、最新のファイルを読み取ります。

v2.1 の新機能 — Drive API による直接アップロード

v2 では、Google Drive デスクトップクライアントを使って ~/Documents/claude-bridge-context.md を Drive に同期していました。v2.1 では、この依存関係をなくしました。MCP サーバーが Drive API に直接接続し、同期のたびに claude-bridge-context という名前の Google ドキュメントを作成または更新します。

セットアップ（初回のみ）：

1. Google Cloud Console で OAuth 認証情報を作成します。

   • console.cloud.google.com にアクセスし、プロジェクトを作成します（または既存のプロジェクトを使用します）。
   • プロジェクトで Google Drive API を有効にします。
   • API とサービス → 認証情報 で、タイプが デスクトップアプリ の OAuth クライアント ID を作成します。
   • クライアント JSON をダウンロードし、~/.claude/bridge-google-credentials.json に保存します。

2. 環境で GOOGLE_DRIVE_ENABLED=true を設定して Drive 同期を有効にし、MCP サーバーを再起動します。Claude Desktop の claude_desktop_config.json では、次のように設定します。

   {
     "mcpServers": {
       "claude-bridge": {
         "command": "node",
         "args": ["/absolute/path/to/claude-code-bridge-mcp/dist/index.js"],
         "env": { "GOOGLE_DRIVE_ENABLED": "true" }
       }
     }
   }
   

3. 接続済みのクライアントから setup_drive_sync ツールを呼び出します。Google の同意画面を表示するブラウザータブが開き、更新トークンが ~/.claude/bridge-google-token.json に保存され、初回アップロードが実行されます。応答にはドキュメントの URL が含まれます。

4. start_auto_sync を呼び出します。以降、同期のたびにローカルの Markdown が書き込まれ、同じ内容が Google ドキュメントに送信されます。今後サーバーを再起動した際は、更新トークンが自動的に再利用されます。

ユーザーに表示される内容：

• Drive のルートに claude-bridge-context という名前の Google ドキュメントが 1 つ作成され、最新の Claude Code セッションの出力で 30 秒ごとに更新されます。
• 任意の Claude Project にソースとして追加するか、直接開くことができます。Drive デスクトップクライアントもコピー＆ペーストも不要です。

無効にする場合： GOOGLE_DRIVE_ENABLED を省略するか、true 以外の値を設定すると、サーバーは v2 と同じように動作します。ローカルの Markdown のみを扱い、Drive への呼び出しは行いません。

インストール

git clone https://github.com/rahuljava2807/claude-code-bridge-mcp.git
cd claude-code-bridge-mcp
npm install
npm run build

Claude Desktop に追加する

claude_desktop_config.json を編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-bridge": {
      "command": "node",
      "args": ["/absolute/path/to/claude-code-bridge-mcp/dist/index.js"]
    }
  }
}

Claude Desktop を再起動します。ツール選択画面に claude-bridge ツールが表示されます。

使い方

一般的なワークフロー：

1. ターミナルで claude を実行して Claude Code セッションを開始し、作業します。
2. Claude Chat で次のように依頼します。

   「list_sessions を使って最新の Claude Code セッションを探し、そのセッションで get_latest_output を呼び出して、Claude Code が直近で行ったことを要約してください。」

3. 長時間実行する Claude Code のタスク中に継続的に出力を取得するには、watch_session を繰り返し呼び出します。呼び出すたびに、前回の呼び出し以降の新しいメッセージのみが返されます。

ツール呼び出しの例

// get_latest_output with no arguments → uses the most recently updated session
{
  "content": "I've refactored the auth middleware to use Fluid Compute...",
  "timestamp": "2026-04-16T15:32:11.441Z",
  "session_id": "01HZ...",
  "project_path": "/Users/you/code/my-app"
}

Claude Code のログ形式

セッションは次の場所に JSONL として保存されます。

~/.claude/projects/<project-hash>/<session-id>.jsonl
~/.claude/projects/<project-hash>/sessions/<session-id>.jsonl

各行は、type、role、content、timestamp などのフィールドを含む 1 つの JSON イベントです。パーサーは形式の違いに対応し、文字列とコンテンツブロックの両方のペイロードからアシスタントのテキストを抽出します。

開発

npm run dev      # tsc --watch
npm run build    # compile to dist/
npm start        # run the compiled server over stdio

ライセンス

MIT — LICENSE を参照してください。