SuperAPI AI 工具集

mcp

智能体与模型

查看项目

更新于 10-26 18:53

技能介绍

用途:该技能用于让支持 MCP 的客户端(Windsurf、Zed、Goose、Gemini CLI、Copilot、Claude Desktop)以工具调用的方式读取 bro 的编排状态,而不是通过 shell 执行命令。资料说明所有机制实现都位于 bro CLI 中,该技能仅属于策略层。

主要能力:bro fleet mcp 通过 stdio MCP 提供 plane 目录(规范见 specs/bro-9rls.1.md)。一个服务器即可覆盖所有支持 MCP 的客户端,无需为每个客户端单独编写适配器。工具由 plane 描述符生成,从不手工维护:每个 plane 上提供 bro_<plane>_list 与 bro_<plane>_get,此外每个已声明的具名读取各对应一个工具,例如 bro_work_ready、bro_queue_next、bro_gates_status、bro_gates_threads、bro_agents_fleet、bro_events_tail、bro_judge_stats、bro_debt_next、bro_debt_summary、bro_learn_probe。v1 为只读;写操作动词在规范中的会话授权问题设计完成前不会暴露,claim、resolve、spawn 等调用不是工具,由于生成是唯一途径,因此不会意外成为工具。

使用方式:bro fleet mcp 应在它要服务的仓库中运行(目录即 catalog 的作用范围)。将客户端的 MCP 配置指向它,方式与任何 stdio 服务器相同:

{ "mcpServers": { "bro": { "command": "bro", "args": ["mcp"], "cwd": "<repo>" } } }

语义约定:tools/list 即发现文档,能力缺失意味着工具缺失——没有 review host 的仓库不会暴露 bro_gates_* 工具,没有 beads 的仓库不会暴露 bro_queue_* 与 bro_learn_*。工具结果为 JSON 文本;后端不可用的 plane 返回 { "error": "<degraded note>" } 并带 isError: true,即降级状态,而非堆栈跟踪或伪造空列表。get 与 exec 引用使用领域稳定键:task id、agentId、mol id、{gen}:{seq}、thread_id。bro.config.json 中的 mcp.planes 可收窄暴露范围:缺失或为空表示全部读取 plane(启动服务器即视为同意),[] 表示不暴露任何 plane,列表则为允许清单。

调试:命令 bro fleet mcp --tools 会打印当前仓库生成的 tools/list 负载(与客户端看到的能力门控一致)并退出。

适用场景:需要从 MCP 客户端直接查询 bro 编排状态的仓库环境。限制:仅只读;写操作未提供;具体支持能力取决于仓库配置与后端状态。