tentra-mcp

npm version npm downloads License: MIT

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

自社のモノレポでのドッグフードベンチマーク結果：8つの「Xはどこに実装されているか？」というクエリにおいて、トークンを99.4%削減（156.8倍の比率）しました。ファイル再読み込みによる114,644トークンに対し、query_symbolsでは731トークンでした。詳細はこちら →

クイックスタート

npx tentra-mcp

初回使用時にブラウザが開き、ワンクリックでGitHubサインインが完了します。APIキーは不要です。

上級者向け: APIキーを直接使用したい場合は、npx tentra-mcp --key YOUR_API_KEY を実行してください。キーは trytentra.com/settings で取得できます。

Tentraとは？

Tentraは、AIコーディングエージェントのための永続的なメモリレイヤーです。システムを記述すると、図と14種類のフレームワークに対応したコードエクスポートが生成されます。リポジトリをインデックス化することで、エージェントはセッションごとにソースを再検索するのではなく、ファイル、シンボル、インポート、呼び出しエッジの構造化されたグラフに対してクエリを実行できます。

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

アーキテクチャ (9ツール)

ツール	説明
`create_architecture`	説明から新しいシステムを設計する
`update_architecture`	既存のアーキテクチャを変更する
`get_architecture`	アーキテクチャの詳細を読み取る
`list_architectures`	保存されたすべての設計を閲覧する
`analyze_codebase`	ローカルコードをスキャンして図を生成する
`lint_architecture`	品質チェック（9つのルール：孤立ノード、単一障害点、巨大サービスなど）
`sync_architecture`	図とコード間の乖離を検出する
`export_architecture`	14種類のフレームワーク（Java、Python、Go、Rustなど）にエクスポートする
`create_flow`	ステップバイステップのフロー図を作成する

コードグラフ — 書き込み (4ツール)

ツール	説明
`index_code`	リポジトリを走査し、ローカルでTree-sitterを実行し、セマンティックインデックス作成ジョブを開始する
`index_code_continue`	進行中のインデックス作成ジョブを再開する
`record_semantic_node`	エージェントが抽出したセマンティックアノテーションを永続化する
`get_index_job`	インデックス作成ジョブのステータスを確認する

コードグラフ — 読み取り (10ツール)

ツール	説明
`query_symbols`	インデックス化されたシンボル全体に対するあいまいトライグラム検索
`get_symbol_neighbors`	呼び出し/インポートグラフのBFS探索
`get_service_code_graph`	キャンバスサービスのサブグラフを取得する
`explain_code_path`	セマンティックコンテキストを伴う2つのシンボル間の最短パスを説明する
`find_similar_code`	エージェントが生成した埋め込みベクトルに対するpgvectorコサイン類似度検索
`record_embedding`	エージェントが生成した埋め込みベクトルを永続化する
`list_god_nodes`	最もファンイン/ファンアウトが多いシンボル（アーキテクチャ上の問題点）をリストアップする
`get_quality_hotspots`	変更頻度 × 複雑度によるランキング
`list_snapshots`	インデックス化されたスナップショットのタイムトラベルリスト
`diff_snapshots`	スナップショット間で追加/削除されたファイル/シンボル/ゴッドノードの差分

エンリッチメント — 契約、決定、所有権、ドメイン (9ツール)

ツール	説明
`set_service_mapping`	インデックス化されたファイルやシンボルをキャンバスサービスにリンクする
`set_domain_membership`	サービスやファイルをドメイン（境界付けられたコンテキスト）に割り当てる
`record_contract`	解析されたAPI契約ペイロード（OpenAPI、GraphQL、Protobuf）を保存する
`bind_contract`	契約をそれを実装するシンボルにリンクする
`record_decision`	アーキテクチャ決定記録（ADR）を作成し、必要に応じてコードにリンクする
`link_decision`	ADRから別のシンボル、ファイル、またはサービスへのリンクを追加する
`get_ownership`	ファイルやサービスの所有者（チームまたは個人）を特定する
`get_decisions_for`	特定のエンティティにリンクされたADRをリストアップする
`get_contracts`	種類やサービスでフィルタリングして契約をリストアップする

セットアップ

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

IDEのMCP設定に追加してください（ローカルインストールは不要です）：

Cursor (設定 > 機能 > MCP > サーバーを追加):

{
  "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

tentra