tianshu-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TIANSHU_MCP_HOME | No | 数据目录默认 ~/.tianshu-mcp，可用环境变量 TIANSHU_MCP_HOME 覆盖；首次启动自动创建。 | ~/.tianshu-mcp |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| prepare_visual_baselineC | 准备视觉基准候选，返回摘要与预览；不采用正式基准。需要用户授权。 |
| approve_visual_baselineA | 仅在用户明确审阅并授权后批准视觉基准。必须核对候选摘要与批准说明；自动返修禁止调用。宿主必须实施实际审批控制。 |
| continue_taskA | 恢复处于 needs_user 的任务。zcode：agent_question 时 message 发往原会话，关闭旧实例/登录/系统权限场景中 message 仅作已处理确认。codex：user_confirmation 时重新接入观察 GUI 内运行（不发送消息）；login_required 时复检环境后重发任务书。 |
| run_taskA | 派活：启动外部 AI-Agent 开发任务并可自动验收返修，异步返回 taskId。ZCode 要求 model=供应商/模型，不支持 mode；TraeWork 的 model 可选并支持 Work/Code/Design mode。task/context 内的 ZCode 项目路径引用会在发送前校验。 |
| query_taskA | 查询任务状态 / 进度 / 最近日志尾部（默认 agent.log 末 40 行）。返回任务 meta 与日志片段。 |
| list_tasksA | 列出历史任务（可按项目路径 / 状态过滤，limit 默认 50）。 |
| get_task_reportA | 取某轮验收报告全文（report.md）。round 缺省取最新一轮。 |
| cancel_taskA | 取消运行中任务：CLI agent 终止进程树；GUI agent（codex 等）尽力点击界面停止按钮并等待 GUI 空闲（有界超时），未确认停止时结果中明示。排队中任务直接移除；终态任务无动作。 |
| verify_taskA | 对已完成任务或项目路径执行一次验收（不改源码）：自动命令检查 + 代码分析（相对 git 基线）。可用 extraChecks 临时加验。需任务/项目二选一。 |
| rework_taskB | 手动返修：把终态任务（failed/needs_attention）重新入队续跑，同一 agent/项目与轮次记账。feedback 为追加指示（建议带上一次验收失败摘要）。 |
| get_profilesA | 查看当前 agent 适配与可执行探测结果（含未安装/调研占位提示）。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool maps to a clearly distinct action or resource: launching, resuming, reworking, canceling, verifying, retrieving, and baseline prep/approval are all separated. Retrieval tools are split by task status/history/report, so there is no meaningful overlap.
All tools follow a consistent snake_case verb_noun pattern such as run_task, cancel_task, list_tasks, and get_profiles. The minor get/list and singular/plural variations do not break the predictable naming convention.
11 tools is well within the well-scoped range, and each tool covers a necessary part of the task orchestration and baseline workflow. The set feels complete without being bloated.
The tool surface covers the full task lifecycle: start, resume, rework, cancel, verify, query, list, and report, plus environment profiles and visual baseline approval. No obvious dead ends or critical missing operations are apparent.