Umtri

umtri-mcp

Umtri 的 MCP 服务——为你的 AI 编码 Agent 提供项目结构、依赖关系和缺陷的持久地图。

你的 Agent 每次会话都会从头重新推导代码库。Umtri 会将结构保存一次，再通过 MCP 提供给它：一棵展示系统由哪些部分组成、各部分之间的调用和依赖关系，以及正在侵蚀系统的缺陷的树。询问“如果我改动这里，哪些地方会出问题？”，就能获得沿着已记录的关联追踪得出的答案，而不是基于 grep 猜测的结果。

快速开始

最快的方式是使用托管端点 https://mcp.umtri.io——无需安装任何东西。在 app.umtri.io → Settings → API Tokens 中生成令牌，然后：

claude mcp add --transport http umtri https://mcp.umtri.io \
  --header "Authorization: Bearer umtri_pat_xxxxxxxxxxxxxxxx"

任何接受配置对象的 MCP 客户端都使用相同的格式：

{
  "mcpServers": {
    "umtri": {
      "type": "http",
      "url": "https://mcp.umtri.io",
      "headers": { "Authorization": "Bearer umtri_pat_xxxxxxxxxxxxxxxx" }
    }
  }
}

自行运行（stdio）

如果你想固定版本，或指向可自托管的 API，请使用此软件包：

claude mcp add umtri \
  -e UMTRI_API_TOKEN=umtri_pat_xxxxxxxxxxxxxxxx \
  --transport stdio \
  -- npx -y umtri-mcp

变量	必需	默认值
UMTRI_API_TOKEN	是	—
UMTRI_API_BASE	否	https://api.umtri.io

设置时不会验证令牌，因此无效令牌也能建立连接，但每次调用都会失败。如果工具显示后又报错，请重新检查令牌及其权限范围——read 令牌无法调用任何写入工具。

工具

读取 — get_graph、get_bug、get_impact、list_projects、list_bugs、list_seasons、list_events

写入 — create_project、create_node、update_node、delete_node（只有设置 cascade: true 才会删除整个子树）、create_edge、delete_edge、create_api、update_api、delete_api、create_bug、update_bug、delete_bug、create_season（仅在用户确认后生效）

计划循环 — commit_plan、record_commit

知识库 — list_wiki、get_wiki、list_wiki_revisions、write_wiki、delete_wiki。Ground 的百科全书：页面构成目录（parent、position），从概览逐级向下读取；每个页面都有类型，每次写入都会返回警告，提示页面是否偏离框架。

反馈 — send_feedback 用于提交关于 Umtri 本身的建议或缺陷报告。

get_graph 返回的是局部视图，而非完整导出：可以按子树（rootId）、层级（maxType）、角色或季节限定范围，也可以单独控制描述的权重。即使树很大，读取成本依然很低。

资源

十份只读文档，Agent 可借此了解领域规则——植物术语（树干/枝/细枝/叶/叶脉）、节点的定义和非节点的内容、季节的运作方式、计划节点的预期实现方式、移植过程中 ground 的行为、如何让树与提交保持同步，以及如何编写和组织知识库。

umtri://rules/vocabulary            umtri://rules/plan
umtri://rules/vocabulary-detailed   umtri://rules/commit-sync
umtri://rules/system-structure      umtri://rules/wiki
umtri://rules/seasons               umtri://templates/wiki
umtri://rules/transplant            umtri://about/vision

链接

• 文档 — https://docs.umtri.io
• 应用 — https://app.umtri.io
• 网站 — https://umtri.io

许可证

Apache-2.0。参见 LICENSE。