agora-mcp

---

廃止

Claude Code がこの機能を自ら提供するようになりました。 セッションは連携し、互いの作業を確認して状態を共有できるため、これを実現するために別途 MCP サーバーを介する必要はなくなりました。

このリポジトリはアーカイブされ、読み取り専用です。今でも動作します — npm から削除されたものはなく、最後に公開されたバージョンも引き続きインストールできます — ただし、今後メンテナンスは行われません。また、その必要もありません。 パッケージではなくアイデアに関心がある場合は、設計の全容が docs/ にあり、ライセンスにより自由に利用できます。

理由

複数の Claude Code セッションが同じリポジトリで作業するとき — 並行している場合も、一日のうちに順次作業する場合も — 互いの状況が見えません。ほかのセッションが何を変更したのか把握できず、同じファイルを気付かないまま上書きし、セッションを閉じるとコンテキストも失われます。

agora は、すべてのセッションが作業の記録を残し、互いの作業を確認できる共有スペースを提供します。

仕組み

システム全体はリポジトリごとに 1 つの SQLite ファイルです：<repo-root>/.agora/space.db（WAL モードを使用するため、複数のプロセスが破損を起こさず同時に読み書きできます）。

• サーバーを実行する必要はありません。 デーモンも Web アプリもありません。「スペース」そのものがファイルです。
• リポジトリの各セッションは、自分の作業内容を書き込み、ほかのセッションの作業内容を読み取ります。
• ファイルなので、状態は自動的に保持されます — すべてを閉じて翌日に戻ってきても、状態はそのままです。
• リアルタイムチャットではなく、共有ボードです。セッションは、開始時、編集しようとするとき（競合）、またはツールで問い合わせたときに状況を確認します。

複数のワークツリーにも対応：.db はメインのリポジトリルートに置かれるため、異なるワークツリーを使用するセッションも含め、リポジトリ内のすべてのセッションが 1 つの agora を共有します。

機能

• 🟢 誰が参加しているか、各セッションがどのファイルを操作しているかをリアルタイムで確認できます。
• ⚠️ 競合の警告 — ほかのアクティブなセッションがすでに確保しているファイル（またはブランチ）を編集する前に警告します。
• 📋 プロジェクトの再開 — セッションを開くと、ほかのセッションの作業内容の概要を取得できます。
• 📓 アクティビティログ — リポジトリ内で発生したすべての出来事を時系列で記録します。
• ✉️ セッション間でメモを送信できます（個別宛てまたは全員宛て）。
• 🛡️ ベストエフォートのフック — どのような場合も 0 で終了し、セッションを妨げることはありません。

必要要件

• Bun 1.3+
• git 2.x
• Claude Code（または任意の MCP クライアント）

インストール

npm から — クローンする必要はありません：

# Register the MCP server — nothing to install for this part
claude mcp add agora -- bunx --bun @vorluno/agora-mcp

# The hooks need the CLI on your PATH. Install once, then run it from any repo.
# Idempotent; add --project to scope it to the current repo only.
bun add -g @vorluno/agora-mcp
agora-init init

ソースから — 変更する場合：

git clone https://github.com/vorluno/agora-mcp.git
cd agora-mcp
bun install
bun run src/cli.ts init
claude mcp add agora -- bun run /absolute/path/to/agora-mcp/src/index.ts

設定

任意の MCP クライアントで使用できます。mcpServers のエントリ：

{
  "mcpServers": {
    "agora": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/agora-mcp/src/index.ts"]
    }
  }
}

Claude Code では、claude mcp add（上記）がこの設定を書き込みます。Warp または Cursor では、スニペットを MCP 設定に貼り付けてください。

ツール

ツール	説明
resume_project	agora の概要：アクティブなセッション、最近のアクティビティ、競合、未読のメモ。
who_is_here	アクティブなセッションと、各セッションが操作しているファイル。
activity_log	リポジトリのイベントログ。時刻またはセッションで絞り込めます。
check_collision	ほかのアクティブなセッションが、これらのファイルまたはこのブランチを操作しているか確認します。
leave_note	ほかのセッションへのメモを残します（または全員に送信します）。
read_notes	セッション宛てのメモを読み取ります（既読としてマークされます）。

衝突の検出方法

• ファイルの衝突： 同じファイルに対して、異なる 2 つ以上のセッションがアクティブな writing クレームを持っている場合です。
• ブランチの衝突： 異なるワークツリーにある 2 つ以上のアクティブなセッションが、同じブランチ上にある場合です。

カウントされるのは実行中のセッションのみです。そのため、正常に終了せずに停止したセッションが誤検知を引き起こすことはありません。

自動キャプチャ（フック）

init は、ベストエフォートのフックを 5 つインストールします（常に exit 0 を実行します）。

フック	動作
SessionStart	セッションを登録し、agora の概要をコンテキストに注入します（/resume の実行時や、コンテキストの圧縮後にも起動します）。
PostToolUse (Edit/Write)	ファイルのクレームとイベントを記録し、新たな衝突が発生した場合に警告します。
PreToolUse (Edit/Write)	別のセッションがすでにファイルを保持している場合、編集前に警告します。
Stop / SessionEnd	セッションをアイドル状態／停止状態にし、そのクレームを解放します。

開発

bun test          # full suite (incl. a real WAL concurrency test)
bunx tsc --noEmit # type-check

タスクごとおよびブランチ全体のレビューを実施しながら、14 の TDD タスクでテストファースト開発を行いました。

貢献とセキュリティ

まず CONTRIBUTING.md をお読みください。プルリクエストが検討対象になるかどうかは、最初の行に記載されています。脆弱性の報告先は [email protected] です。イシューには報告しないでください。SECURITY.md をご覧ください。72 時間以内の受領確認は、当社が約束する唯一の対応時間です。

ライセンス

Apache-2.0 © 2026 Vorluno。NOTICE をご覧ください。

0.1.0 までのバージョンは MIT ライセンスでした。これらのリリースは引き続き MIT ライセンスです。一度付与したライセンスを撤回することはできません。0.2.0 以降は、特許権を明示的に付与する Apache-2.0 です。

---