MCACP MCP

MCACP

将任何MCP客户端桥接到任何ACP编码代理。

MCACP是一个 主控程序 服务器说 代理客户端协议 代表您的MCP主机。它允许Claude Code、Zed、VS Code或任何兼容MCP的客户端生成、管理ACP编码代理并与之交互——将单个聊天窗口变成多代理控制平面。

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分配相同的任务，并比较结果。

构建代理驱动的管道。 一个代理编写代码，另一个代理审查代码，第三个代理运行测试。MCACP处理所有这些应用程序的生命周期和权限流。

以交互方式控制权限。 在支持MCP启发（Zed）的主机上，权限请求以交互形式弹出。在没有（Claude Code）的主机上，它们会退回到由主机代理决定的操作员模式。

从你中断的地方继续。 会话持续到磁盘。关机，重启， load_session --特工从停车处接车。

通过聊天发现并安装代理。 浏览ACP注册表，安装代理，检查升级——不要离开你的对话。

快速开始

安装

npm install -g mcacp

或者直接运行：

npx mcacp

添加到您的MCP客户端

克劳德代码 (~/.claude/settings.json):

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

泽德 (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公开了22个工具，分为五组。

注册表

生命周期

会话

交互

状态

权限策略

每个会话可以使用不同的策略：

操作员流程

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

配置

MCACP寻找 mcacp.json 在这些地点（首次发现获胜）：

1. --config 旗帜或 MCACP_CONFIG env 是
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

许可证

阿帕奇-2.0