OpenRig MCP服务器全解18个工具让Agent自管理拓扑【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 是一个用 YAML 定义 Agent 团队、一条命令启动的开源项目它的 MCP 服务器MCP server是其中最容易被忽视的能力通过rig mcp serve启动后Claude Code、Codex 等 Agent 就能像进程管理器一样自管理自己的运行拓扑——启动团队、查看状态、发送消息、抓取终端输出全部由 Agent 自己完成。 它是什么给 Agent 装的驾驶舱OpenRig 由四部分组成本地守护进程daemon、rig命令行工具、终端 UITUI和 MCP 服务器全部通过本地 HTTP 通信底层运行在 tmux 之上CLI / TUI / MCP | Hono HTTP daemon | Domain services | SQLite tmux runtime adapters其中MCP 服务器的角色是桥它通过 stdio 传输接入任意 MCP 客户端把守护进程的全部能力封装成 18 个标准 MCP 工具。核心实现在 mcp-server.ts启动命令在 mcp.ts。对新手来说最直观的理解是CLI 是给人用的遥控器而 MCP 工具是给 Agent 用的遥控器——同一套能力两个入口。 快速开始三步接入 OpenRig MCP 服务器第 1 步安装 CLI需要 Node.js 22/24 tmuxmacOS 或 Linuxnpm install -g openrig/cli第 2 步确保守护进程在运行然后启动 MCP 服务器rig mcp serve它会自动探测守护进程的端口并连接也可以显式指定rig mcp serve --port port。第 3 步在 MCP 客户端中登记该 stdio 命令客户端即可发现全部 18 个rig_*工具。无需额外配置网络——传输走 stdio安全边界就在本机。 18个MCP工具速查表按用途分组一眼看懂 OpenRig MCP 服务器的完整能力面分组工具一句话说明⚙️ 生命周期rig_up从 spec 或 bundle 启动引导一个 rig⚙️ 生命周期rig_down拆毁 rig可选先打快照或强制停止⚙️ 生命周期rig_ps列出所有 rig 及其状态进程列表⚙️ 生命周期rig_status检查守护进程健康 快照恢复rig_snapshot_create为 rig 创建快照 快照恢复rig_snapshot_list列出 rig 的全部快照 快照恢复rig_restore从快照恢复 rig 发现绑定rig_discover扫描 tmux 中可发现的会话 发现绑定rig_bind把发现的会话绑定进拓扑挂到现有节点或新建节点✅ 校验rig_agent_validate校验 AgentSpecagent.yaml文本✅ 校验rig_rig_validate校验 RigSpecrig.yaml文本✅ 校验rig_bundle_inspect检查 .rigbundle 包完整性 拓扑交互rig_rig_nodes查看 rig 的节点清单会话名、状态、attach 命令 拓扑交互rig_send可靠两步投递向 Agent 终端发送消息 拓扑交互rig_capture抓取 Agent 终端输出可按 session/rig/pod 范围 聊天室rig_chatroom_send向 rig 的聊天室发消息 聊天室rig_chatroom_watch读取聊天室最近 20 条历史➕ 动态扩编rig_add向运行中 rig 的 Pod 加入单个新成员 高频工具详解从启动到沟通rig_up一键拉起 Agent 团队rig_up对应守护进程的/api/up接口接受sourceRefYAML spec 或 .rigbundle 路径并支持plan预览不执行和autoApprove自动批准可信操作参数。注意它对长任务做了 120 秒超时处理——拉起一个多座位团队本来就不是秒级操作。rig_ps / rig_statusAgent 的ps auxrig_ps返回所有 rig 及状态是 Agent 巡检的第一站rig_status则直接打守护进程的/healthz判断系统本身是否健康。这两个工具让 Agent 在动手前先看表避免对不存在的 rig 操作。rig_send / rig_capture可信的消息与观察rig_send采用可靠两步投递向目标会话终端发消息可选verify校验内容是否真的落屏可选waitForIdleSeconds等待目标明确空闲后再发避免打断进行中的任务。rig_capture是它的镜像面抓取终端最后 N 行支持单会话、整个 rig 或整个 Pod 三种粒度。两者一写一读构成 Agent 观察队友的最小闭环。rig_chatroom_send / rig_chatroom_watch团队聊天室聊天室按 rig 名寻址服务端自动把名字解析成 ID重名会明确报歧义错误。一个有意思的细节sender参数已废弃——发送者身份由 MCP 服务器的会话头自动推导防止 Agent 冒充他人发言。rig_snapshot_create / rig_restore随时存档一键回档三件套创建 / 列表 / 恢复让拓扑变成可持久化的资产团队跑到关键节点先打快照出问题从快照恢复配合rig_down的snapshot选项还能在拆毁前自动存档。rig_discover / rig_bind把野会话纳入版图如果你已经手动跑了一些 tmux 会话rig_discover扫描它们rig_bind把发现的会话绑到现有节点、或作为新成员创建进某个 Pod——拓扑不必从零建也能收编存量。 场景Agent 如何自管理拓扑把这些工具串起来就是一个典型的自管理循环巡检Lead Agent 调用rig_psrig_status确认团队在线、守护进程健康观察用rig_capture看各座位终端最近输出判断谁在忙、谁卡住派活用rig_send带waitForIdleSeconds给空闲座位发消息或rig_chatroom_send在团队聊天室同步进展扩编任务量变大时用rig_add向 Pod 里加一个新成员身份迁移零开销不重键任何现有节点存档里程碑达成后rig_snapshot_create随时可rig_restore回档。整个过程中人只需要看 TUI 或偶尔介入——这正是 OpenRig 说的 persistent teams with roles, shared context and owned work有角色、共享上下文、各管各的活。⚠️ 三个新手容易踩的坑MCP 服务器不替代守护进程rig mcp serve只是 API 的 stdio 封装daemon 必须先起来错误是诚实的工具结果按 HTTP 状态、响应体 error 字段、结构级失败三级判定isError见 mcp-server.tsrig_add即使返回 201若新节点没真正 launched 也会标记为错误rig_send 的两个互斥参数force目标忙也发与waitForIdleSeconds等空闲再发不可同时使用混用会直接报错。 源码与文档索引想深入 OpenRig MCP 服务器的实现这些相对路径是最好的入口MCP 工具注册与错误映射packages/cli/src/mcp-server.tsrig mcp serve命令入口packages/cli/src/commands/mcp.ts守护进程 HTTP 客户端MCP 的后端packages/cli/src/client.ts架构总览含 18 个工具的计数约定ARCHITECTURE.mdrig mcp官方命令参考docs/as-built/cli-reference.mdMCP 服务器行为测试packages/cli/test/mcp-server.test.ts一句话总结OpenRig MCP 服务器把管理一队 AI Agent这件事从人的活变成了 Agent 的活——rig_up管生rig_down管灭rig_ps管看rig_send管聊18 个工具拼出一张完整的自管理拓扑驾驶舱。【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考