tentra-mcp

👁 npm version
👁 npm downloads
👁 CI
👁 License: MIT

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

自社のモノレポでのベンチマーク結果：8つの「Xはどこに実装されているか？」というクエリにおいて、トークンを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。

Related MCP server: codecortex

Tentraとは？

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

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

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

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

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

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

セットアップ

オプション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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• analyze_codebaseA
• bind_contractA
• create_architectureA
• create_flowA
• diff_snapshotsA
• explain_code_pathA
• export_architectureB
• find_similar_codeC