Tentra — Memory for AI Coding Agents

tentra-mcp

AI コーディングエージェントのためのメモリです。永続的なコードグラフと AI 生成のアーキテクチャ図を、MCP ネイティブで提供します。Cursor、Claude Code、Codex、Windsurf で動作します。

自社のモノレポを使った実測ベンチマークでは、「X はどこに実装されている？」という 8 件のクエリで、トークンを 99.4% 削減（156.8 倍）しました。ファイルの再読み込みでは 114,644 トークン、query_symbols では 731 トークンでした。測定結果の全文 →

クイックスタート（60 秒）

cd your-repo
npx tentra-mcp init --hook

次のコマンドを実行します。

1. Cursor / Claude Code / Codex / Windsurf（インストール済みのもの）向けに MCP 設定を書き込みます
2. git post-commit フックをインストールし、コミットのたびにコードグラフを自動更新します。手動での再インデックスは不要です
3. git リモートから repo_id を自動で導出し、.tentra/metadata.json に保存します

続いて、trytentra.com/settings で API キーを取得し、生成された設定内の YOUR_TENTRA_API_KEY を置き換えて IDE を再読み込みし、エージェントに尋ねてください。

Index this codebase with Tentra and list the god-nodes

以降は git commit のたびにバックグラウンドで再インデックスが実行されます。エージェントは自動的に最新の状態を保ちます。

フックをスキップする場合： --hook を外すと、IDE の設定のみを書き込みます。 stdio を手動でインストールする場合： npx tentra-mcp（最初のツール呼び出し時に GitHub のデバイスフロー認証用ブラウザーが開きます）。 API キーを使う場合： npx tentra-mcp --key YOUR_API_KEY。

Tentra とは？

Tentra は、エンジニアリングチーム向けの AI ネイティブなアーキテクチャプラットフォームです。システムを説明すると、図と 14 種類のフレームワーク向けコードを生成できます。リポジトリをインデックス化すると、エージェントはセッションごとにソースを再検索する代わりに、ファイル、シンボル、インポート、呼び出し関係をまとめた構造化グラフをクエリできます。

この MCP サーバーは、AI アシスタントに 36 個のツールを提供します。

アーキテクチャ（10 個のツール）

ツール	説明
create_architecture	説明をもとに新しいシステムを設計します
update_architecture	既存のアーキテクチャを変更します
get_architecture	アーキテクチャの詳細を読み込みます
list_architectures	保存済みの設計を一覧表示します
analyze_codebase	ローカルコードをスキャンして図を生成します
lint_architecture	品質チェックを実行します（9 つのルール：孤立要素、SPOF、巨大サービス）
sync_architecture	図とコードの間にある乖離を検出します
get_spec_alignment	実装途中の乖離チェックです。変更ファイルを入力すると、仕様のコンテキストと乖離の兆候を出力します
export_architecture	14 種類のフレームワーク（Java、Python、Go、Rust など）向けにエクスポートします
create_flow	手順を示すフロー図を作成します

コードグラフ — 書き込み（4 個のツール）

ツール	説明
index_code	リポジトリを走査し、Tree-sitter でローカル処理して、セマンティックインデックス作成ジョブを開始します
index_code_continue	進行中のインデックス作成ジョブを再開します
record_semantic_node	エージェントが抽出したセマンティック注釈を保存します
get_index_job	インデックス作成ジョブの状態を確認します

コードグラフ — 読み取り（13 個のツール）

ツール	説明
query_symbols	インデックス済みシンボルをトライグラムであいまい検索します
find_references	シンボルを呼び出す解決済みの箇所をすべて検索します — リファクタリングの安全性を支える基盤です
safe_rename	シンボルの名前変更に向けたパッチ計画（定義とすべての呼び出し箇所）を作成します
explain_codebase	リポジトリ全体をエージェント向けに説明します
get_symbol_neighbors	呼び出し／インポートグラフを幅優先探索します
get_service_code_graph	キャンバスサービスのサブグラフを取得します
explain_code_path	セマンティックなコンテキストを含む、2 つのシンボル間の最短経路を示します
find_similar_code	エージェントが生成した埋め込みを対象に、pgvector のコサイン類似度 ANN 検索を行います
record_embedding	エージェントが生成した埋め込みベクトルを保存します
list_god_nodes	入次数／出次数が最も高いシンボルを表示します（アーキテクチャ上の問題の兆候）
get_quality_hotspots	変更頻度 × 複雑度のランキングを表示します
list_snapshots	インデックス済みスナップショットの履歴を一覧表示します
diff_snapshots	スナップショット間で追加／削除されたファイル／シンボル／god-nodeを表示します

エンリッチメント — コントラクト、意思決定、所有者、ドメイン（9 個のツール）

ツール	説明
set_service_mapping	インデックス済みのファイルまたはシンボルをキャンバスサービスに関連付けます
set_domain_membership	サービスまたはファイルをドメイン（境界づけられたコンテキスト）に割り当てます
record_contract	解析済みの API コントラクトペイロード（OpenAPI、GraphQL、Protobuf）を保存します
bind_contract	コントラクトを、それを実装するシンボルに関連付けます
record_decision	必要に応じてコードと関連付けたアーキテクチャ決定記録を作成します
link_decision	ADR から別のシンボル、ファイル、またはサービスへのリンクを追加します
get_ownership	ファイルまたはサービスの所有者（チームまたは個人）を特定します
get_decisions_for	指定したエンティティに関連付けられた ADR を一覧表示します
get_contracts	コントラクトを一覧表示します。種類またはサービスでの絞り込みも可能です

セットアップ

オプション 1：SSE（インストール不要）

IDE の MCP 設定に追加します。ローカルへのインストールは不要です。

Cursor（Settings > Features > MCP > Add Server）：

{
  "tentra": {
    "type": "sse",
    "url": "https://trytentra.com/api/mcp?key=YOUR_API_KEY"
  }
}

Claude Code（プロジェクトのルートにある .mcp.json）：

{
  "mcpServers": {
    "tentra": {
      "type": "sse",
      "url": "https://trytentra.com/api/mcp?key=YOUR_API_KEY"
    }
  }
}

オプション 2：ローカルインストール（コードベースのスキャンに必要）

npx tentra-mcp

初回使用時に GitHub で自動的に認証されます。認証情報は ~/.tentra/credentials に保存されます。

Cursor のローカルサーバー設定：

{
  "tentra": {
    "command": "npx",
    "args": ["tentra-mcp"]
  }
}

Claude Code（.mcp.json）：

{
  "mcpServers": {
    "tentra": {
      "command": "npx",
      "args": ["tentra-mcp"]
    }
  }
}

使用例

接続したら、AI に話しかけるだけです。

"Design a payment system with Stripe, Kafka, and PostgreSQL"
→ AI calls create_architecture → diagram at trytentra.com/arch/xxx

"Scan this codebase and generate the architecture"
→ AI calls analyze_codebase → detects services, DBs, queues

"Export this architecture to Java Spring Boot"
→ AI calls export_architecture → downloads zip with project scaffold

"What changed since last time? Is my diagram outdated?"
→ AI calls sync_architecture → drift report with accuracy score

エクスポート形式

Java（Spring Boot）、Node.js（Fastify）、Python（FastAPI）、Go（chi）、Rust（Axum）、.NET（ASP.NET）、Kotlin（Ktor）、PHP（Laravel）、Ruby（Rails）、Elixir（Phoenix）、Docker Compose、Mermaid、ADR、Terraform

リンク

• ウェブサイト：trytentra.com
• ドキュメント：trytentra.com/docs
• セットアップガイド：trytentra.com/docs/setup
• ギャラリー：trytentra.com/gallery

開発

このリポジトリにはオープンソースの MCP サーバーが含まれています。Tentra API とウェブアプリは、trytentra.com で提供される別個のホステッドサービスです。

npm install --legacy-peer-deps
npm run build      # tsc --noEmit + esbuild bundle → dist/index.js
npm start          # run the bundled server
npm test           # vitest

公開されている npm パッケージ（tentra-mcp）には、バンドル済みの dist/ のみが含まれます。ソースは監査可能性とコミュニティからの貢献のためにここで公開されています。

ライセンス

MIT