Umtri

umtri-mcp

Umtri 用の MCP サーバーです。AI コーディングエージェントに、プロジェクトの構造、依存関係、バグの永続的なマップを提供します。

エージェントはセッションのたびに、コードベースを一から把握し直します。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

Wiki — list_wiki、get_wiki、list_wiki_revisions、write_wiki、delete_wiki。ground の百科事典です。ページは目次（parent、position）を構成し、概要から読み進められます。それぞれに種類があり、ページの内容が骨組みから外れている場合、書き込みのたびに警告が返されます。

フィードバック — send_feedback は、Umtri 自体への提案や不具合を報告します。

get_graph が返すのは全データではなく、範囲を指定した一部です。サブツリー（rootId）、レイヤー（maxType）、役割、またはシーズンで範囲を絞り、説明の詳しさも個別に調整できます。大きなツリーでも、低コストで読み取れます。

リソース

エージェントがドメインのルールを確認するために取得できる、読み取り専用のドキュメントが 10 個あります。植物に由来する用語（幹／枝／小枝／葉／葉脈）、ノードに該当するものとしないもの、シーズンの仕組み、計画ノードを実現する方法、移植中の ground の振る舞い、コミットに合わせてツリーを維持する方法、Wiki の執筆と整理の方法を扱います。

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 を参照してください。