tentra-mcp

npm version npm downloads License: MIT

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

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

快速开始

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`	带有语义上下文的两个符号之间的最短路径
`find_similar_code`	对代理生成的嵌入向量进行 pgvector 余弦 ANN 搜索
`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

链接

开发

此仓库包含开源的 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

tentra