Mcacp

🚀 MCACP

MCACP 能夠將任何 MCP 客戶端連接到任何 ACP 編碼代理。它是一個 MCP 服務器，可代表你的 MCP 主機使用 Agent Client Protocol。藉助 MCACP，Claude Code、Zed、VS Code 或任何與 MCP 兼容的客戶端都可以生成、管理並與 ACP 編碼代理進行交互，從而將單個聊天窗口轉變為多代理控制平面。

MCP 客戶端 (Claude Code、Zed、VS Code 等)
    |
    |  MCP (標準輸入輸出)
    v
  MCACP
    |
    |  ACP (標準輸入輸出，每個代理)
    v
 Claude Code  ·  Gemini CLI  ·  Codex  ·  Auggie  ·  Copilot  ·  ...

🚀 快速開始

📦 安裝

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"] }
    }
  }
}

然後在聊天中執行以下操作：

"搜索可用代理"        →  registry_search
"安裝 Gemini 代理"   →  agent_install
"初始化並啟動會話"    →  initialize + new_session
"要求其重構認證部分"  →  prompt_start + prompt

✨ 主要特性

• 從任何 MCP 客戶端運行任何 ACP 代理：無需為每個代理單獨安裝專用的 IDE 插件。可以從 Claude Code 安裝 Gemini，從 Zed 運行 Codex，實現自由組合。
• 並排比較代理：在並行會話中向 Claude Code ACP 和 Gemini CLI 分配相同的任務，並比較結果。
• 構建代理驅動的管道：一個代理編寫代碼，另一個進行審查，第三個運行測試。MCACP 負責處理所有代理的生命週期和權限流程。
• 交互式控制權限：在支持 MCP 詢問的主機（如 Zed）上，權限請求會以交互式表單的形式彈出；在不支持的主機（如 Claude Code）上，則會回退到操作員模式，由主機代理做出決策。
• 斷點續傳：會話會持久化到磁盤。關閉、重啟、使用 load_session 命令，代理可以從停止的位置繼續工作。
• 在聊天中發現和安裝代理：無需離開對話，即可瀏覽 ACP 註冊表、安裝代理並檢查升級。

💻 使用示例

基礎用法

# 安裝 MCACP
npm install -g mcacp

# 直接運行 MCACP
npx mcacp

高級用法

// 在 Claude Code 的配置文件中添加 MCACP
{
  "mcpServers": {
    "mcacp": {
      "command": "npx",
      "args": ["-y", "mcacp"]
    }
  }
}

// 在 Zed 的配置文件中添加 MCACP
{
  "context_servers": {
    "mcacp": {
      "command": { "path": "npx", "args": ["-y", "mcacp"] }
    }
  }
}

📚 詳細文檔

MCP 工具

MCACP 提供了 22 個工具，分為五組。

註冊表

生命週期

會話

交互

狀態

權限策略

每個會話可以使用不同的策略：

操作員流程

編排器                   MCACP                      ACP 代理
    |                            |                            |
    |-- 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