这个项目能做什么

# coding-agents-mcp `coding-agents-mcp` 是一个 Agent Hypervisor 和通用 Model Context Protocol (MCP) 网关，专为编排自主 CLI 编码代理而设计。它允许 AI 监督者、IDE（如 Cursor 和 Windsurf）以及桌面助手（如 Claude Desktop 和 Google Antigravity）管理下属编码代理，包括 Anthropic 的 Claude Code、Google 的 Antigravity、OpenAI 的 Codex 和 Cursor Agent。 ## 核心理念 该项目强调可靠的简洁性，以及在 macOS、Linux 和 Windows 上严格的跨平台一致性。关键架构特性包括： * **零守护进程 / 零 Root：** 作为纯非特权 Node.js stdio 进程运行。无需 Docker 守护进程、root 权限或后台服务。 * **通过 Git Worktrees 实现通用沙箱：** 在专用分支上的隔离、临时 Git worktree 中执行代理运行。这消除了文件频繁变动和锁争用，允许安全地合并或丢弃操作。 * **跨操作系统一致性：** 拒绝脆弱的操作系统特定虚拟化孤岛。所有隔离、安全和委派功能使用标准 Git 和 Node.js 原语，在各操作系统上以相同方式运行。 * **进程安全：** 在 Unix 上使用标准 POSIX 进程组，在 Windows 上使用 `taskkill`，实现防孤儿的进程回收，确保干净地拆除。 ## 关键能力 1. **代理 Hypervisor 范式：** 提供面向目标的基板，由监督模型决定意图、不变量和验收标准，而下属代理自主执行微观决策。 2. **有状态会话：** 自动保留跨调用的多轮对话记忆，且零 token 传输开销。 3. **代理间交接：** 使用结构化数据包（目标、文件清单、git diff）而非原始转录在不同模型之间转移任务，防止上下文窗口爆炸。 4. **多代理编排：** 支持内置的声明式拓扑，如 `architect_builder`、`peer_review` 以及带自动回滚和 diff 验证的自定义 DAG。 5. **临时沙箱：** 使用分离的 worktree 隔离代理运行，确保主工作区保持干净，直到更改被显式合并。 ## 支持的代理 | 代理 | CLI 二进制文件 | 状态 | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | 已支持 | | Google Antigravity | `agy` | 已支持 | | OpenAI Codex CLI | `codex` | 适配器就绪 | | Cursor Agent | `cursor` | 适配器就绪 | ## 工具集参考 该网关公开了多个用于委派、检查和编排的工具： * **核心委派：** `delegate_task` 用于自主结对编程，`delegate_ask` 用于只读查询，`delegate_diff` 用于工作区检查。 * **会话管理：** `delegate_sessions` 和 `delegate_reset` 用于管理对话状态。 * **Worktree 管理：** `delegate_worktree` 用于列出、检查、合并或丢弃隔离的沙箱。 * **编排：** `delegate_pipeline` 用于多代理工作流，`delegate_handoff` 用于结构化任务转移。 * **消息传递：** `agent_mailbox` 用于代理之间的异步协调。 ## 快速开始 通过 `npx` 直接运行： ```bash npx -y coding-agents-mcp ``` ### 配置示例 **Claude Desktop (`claude_desktop_config.json`)：** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp"] } } } ``` **Cursor (`~/.cursor/mcp.json`)：** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp"] } } } ``` **Google Antigravity Sidecar：** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp", "--compat=agy"] } } } ``` ## 开发 本地构建和测试： ```bash git clone https://github.com/funkyfunc/coding-agents-mcp.git cd coding-agents-mcp npm install npm run build npm test ``` 该项目采用 MIT 许可证。