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