mcacp

MCACP

あらゆる MCP クライアントをあらゆる ACP コーディングエージェントに接続します。

MCACP は、MCP ホストに代わって Agent Client Protocol を使用する MCP サーバーです。Claude Code、Zed、VS Code、その他の MCP 互換クライアントから ACP コーディングエージェントを起動、管理、操作できるため、1 つのチャットウィンドウをマルチエージェントのコントロールプレーンに変えられます。

MCP Client (Claude Code, Zed, VS Code, ...)
    |
    |  MCP (stdio)
    v
  MCACP
    |
    |  ACP (stdio, per agent)
    v
 Claude Code  ·  Gemini CLI  ·  Codex  ·  Auggie  ·  Copilot  ·  ...

これを使うと何ができますか？

あらゆる MCP クライアントからあらゆる ACP エージェントを実行できます。 エージェントごとに専用の IDE プラグインを用意する必要はありません。Claude Code から Gemini をインストールしたり、Zed から Codex を実行したりと、自由に組み合わせられます。

エージェントを並べて比較できます。 同じタスクを Claude Code ACP と Gemini CLI に並行セッションで与え、結果を比較できます。

エージェント主導のパイプラインを構築できます。 あるエージェントにコードを書かせ、別のエージェントにレビューさせ、3 つ目のエージェントにテストを実行させます。MCACP は、すべてのエージェントのライフサイクルと権限のフローを管理します。

権限を対話形式で制御できます。 MCP elicitation に対応しているホスト（Zed）では、権限リクエストが対話型フォームとして表示されます。対応していないホスト（Claude Code）では、ホストエージェントが判断するオペレーターモードに切り替わります。

中断したところから再開できます。 セッションはディスクに保存されます。シャットダウンして再起動した後、load_session を実行すると、エージェントは停止したところから再開します。

チャットからエージェントを見つけてインストールできます。 会話を離れることなく、ACP レジストリの閲覧、エージェントのインストール、アップグレードの確認ができます。

クイックスタート

インストール

npm install -g mcacp

または、直接実行します。

npx mcacp

MCP クライアントに追加する

Claude Code（~/.claude/settings.json）：

{
  "mcpServers": {
    "mcacp": {
      "command": "npx",
      "args": ["-y", "mcacp"]
    }
  }
}

Zed（settings.json）：

{
  "context_servers": {
    "mcacp": {
      "command": { "path": "npx", "args": ["-y", "mcacp"] }
    }
  }
}

その後、チャットから次を実行します。

"Search for available agents"        →  registry_search
"Install the Gemini agent"           →  agent_install
"Initialize it and start a session"  →  initialize + new_session
"Ask it to refactor auth"            →  prompt_start + prompt

MCP ツール

MCACP は、5 つのグループに分類された 22 個のツールを公開します。

レジストリ

ツール	説明
list_installed_agents	ローカルにインストールされているエージェントの一覧を表示します
registry_search	ACP エージェントレジストリを検索します
agent_install	レジストリからエージェントをインストールします
agent_uninstall	インストール済みエージェントを削除します
agent_check_upgrades	利用可能なアップグレードを確認します
discover_agents	エディター設定（Zed、JetBrains）をスキャンしてエージェントを検出します
reload_config	ディスクから mcacp.json を再読み込みします

ライフサイクル

ツール	説明
initialize	エージェントプロセスを起動し、ACP ハンドシェイクを実行します
shutdown	エージェントを正常にシャットダウンします

セッション

ツール	説明
new_session	作業ディレクトリと権限ポリシーを指定してセッションを作成します
load_session	保存済みのセッションを再開します
list_sessions	エージェントの保存済みセッション一覧を表示します
close_session	セッションを終了します（後で再開できるように保持されます）

操作

ツール	説明
prompt_start	プロンプトを送信します（すぐに戻ります）
prompt	イベントが利用可能になるまで待機します
prompt_events	イベントをブロックせずにポーリングします
grant_permission	保留中の権限リクエストを解決します（オペレーターモード）
request_permission	権限を判断するため、ホストに MCP elicitation を送信します
cancel	進行中のプロンプトをキャンセルします
set_mode	エージェントの動作モードを切り替えます

ステータス

ツール	説明
list_running_agents	ステータスとセッションを含むすべてのエージェントの一覧を表示します
get_agent_status	実行中のエージェントの詳細なステータスを取得します
set_agent_status	エージェントのステータステキストを設定します

権限ポリシー

各セッションには、異なるポリシーを適用できます。

ポリシー	動作
allow_all	エージェントのすべてのアクションを自動承認します
deny_all	すべてのツール使用をブロックします
elicit	MCP elicitation としてホストに転送します。サポートされていない場合は operator にフォールバックします
operator	イベントとしてキューに入れ、ホストエージェントが grant_permission で判断します

オペレーターフロー

Orchestrator                   MCACP                      ACP Agent
    |                            |                            |
    |-- prompt(sessionId, ...) ->|                            |
    |                            |-- session/prompt --------->|
    |                            |<- request_permission ------|
    |<- {pendingPermission: ...} |                            |
    |                            |                            |
    |-- grant_permission ------->|                            |
    |   {toolCallId, optionId}   |-- permission outcome ----->|
    |                            |<- prompt result -----------|
    |<- {stopReason, updates}    |                            |

設定

MCACP は次の場所にある mcacp.json を探します（最初に見つかったものが使用されます）。

1. --config フラグまたは MCACP_CONFIG 環境変数
2. カレントディレクトリ内の .mcacp/mcacp.json
3. ~/.config/mcacp/mcacp.json

{
  "registries": ["https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json"],
  "defaultPermissionPolicy": "elicit",
  "agent_servers": {
    "my-custom-agent": {
      "command": "node",
      "args": ["my-agent.js"]
    }
  }
}

スキーマの詳細については、docs/configuration.md を参照してください。

ソースからビルドする

git clone https://github.com/Oortonaut/mcacp.git
cd mcacp
npm install
npm run build
node dist/index.js

ライセンス

Apache-2.0