tentra-mcp

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

AI 编码代理的记忆层。持久化代码图谱 + AI 生成的架构图 —— 原生支持 MCP。适用于 Cursor、Claude Code、Codex 和 Windsurf。

在我们自己的代码仓库中进行的基准测试：在 8 个“X 是在哪里实现的？”查询中，Token 减少了 99.4%（比例为 156.8 倍）—— 通过文件重读需要 114,644 个 Token，而通过 query_symbols 仅需 731 个 Token。完整报告 →

快速入门（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 种框架的代码导出。索引您的仓库 —— 代理查询的是文件、符号、导入和调用边的结构化图谱，而不是每次会话都重新 grep 源代码。

此 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 和 Web 应用是托管在 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