lanlan0811/tianshu-mcp

天枢 × AI-Agent 编排 MCP server：把 其他AI-Agent 当作执行工人，自动完成「开发 → 验收 → 失败返修 → 再验收」闭环。

About tianshu-mcp

由天枢（Tianshu）当作标准 MCP server 接入，调度外部 AI-Agent（Codex CLI；TraeWork/TRAE SOLO CN 经 CDP 驱动桌面 UI）完成 项目开发 → 验收 → 失败返修 → 再验收 的闭环（架构可横向扩展）。

天枢官方仓库：github.com/huiliyi37/Tianshu-harness —— 基于 harness 工程的终端编程智能体运行时（TUI × GUI），本 MCP 作为其 MCP server 接入。

天枢的角色是总指挥；本 MCP server 是调度层 + 执行面 + 客观验收仪；外部 AI-Agent（Codex CLI、TraeWork GUI）是执行开发的「工人」。

- 9 个 MCP 工具：runtask / continuetask / querytask / listtasks / gettaskreport / canceltask / verifytask / reworktask / getprofiles。 - 异步契约：runtask 秒回 taskId，长任务用 querytask 轮询（长任务不卡 tools/call）。 - 客观验收：自动命令检查（typecheck/lint/test/build，缺则跳过 + 技术栈推导）+ 程序化代码分析（变更清单/diffstat/TODO·debugger·密钥形态等可疑标记），全部相对 git 基线，不自动 commit/stash。 - 失败返修闭环：自动返修（autoFixRounds）+ 手动 reworktask；验收失败时自动生成修复计划文件并回填给 agent；轮次用尽 → needsattention 等天枢裁决。 - 两种执行面：driver: "spawn" 走外部 CLI 子进程（Codex）；driver: "gui" 由显式 adapter 驱动桌面 UI（TraeWork 与 ZCode 各自使用隔离的 CDP 流程）。 - 调度纪律：每项目串行队列 + 全局并发上限（默认 2，可配）。 - 不碰密钥：各 agent 用自己的登录态；本 server 不保存/转发任何 API key。 - 可扩展：新 agent = 一个 profile（数据）+（如需）一个 adapter 文件，零改编排核心。

项 要求 ------ Node.js ≥ 20（CI 覆盖 20 / 22 / 24） 包管理器 npm（仓库含 package-lock.json） 操作系统 Windows / macOS / Linux（CI 三平台矩阵验证） Git 可选；验收的基线分析在 git 仓库内更完整

数据目录默认 ~/.tianshu-mcp，可用环境变量 TIANSHUMCPHOME 覆盖；首次启动自动创建。

天枢「设置 → MCP 服务器 → 添加」，按下面填写即可（传输方式选 stdio（本地进程））：

字段 npm 分发（推荐） 本地开发 --------- 服务器 ID tianshu-mcp tianshu-mcp 传输方式 stdio（本地进程） stdio（本地进程） 命令 npx node 参数（空格分隔） -y tianshu-mcp /dist/index.js

- 服务器 ID 即工具前缀：填 tianshu-mcp 后工具名为 mcptianshu-mcpruntask 等 9 个。 - 参数按空格分隔填写，不要加引号；本地开发模式请把 换成真实绝对路径（如 D:/Trae项目/tianshu-mcp/dist/index.js）。 - 界面未提供环境变量输入框；如需自定义数据目录，改用下面的 config.json 方式设置 TIANSHUMC

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/lanlan0811--tianshu-mcp.html)

Related MCP servers