tentra-mcp

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

Memoria para agentes de codificación de IA. Grafo de código persistente + diagramas de arquitectura generados por IA — nativo de MCP. Funciona en Cursor, Claude Code, Codex y Windsurf.

Benchmark de uso interno en nuestro propio monorepo: 99.4% de reducción de tokens (ratio de 156.8×) en 8 consultas de "¿dónde está implementado X?" — 114,644 tokens mediante relectura de archivos frente a 731 tokens mediante query_symbols. Artículo completo →

Inicio rápido (60 segundos)

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

Un comando:

1. Escribe la configuración de MCP para Cursor / Claude Code / Codex / Windsurf (los que estén instalados)

2. Instala un hook de git post-commit para que el grafo de código se actualice automáticamente después de cada commit — sin reindexación manual

3. Deriva automáticamente tu repo_id desde el remoto de git y lo guarda en .tentra/metadata.json

Luego obtén tu clave de API en trytentra.com/settings, reemplaza YOUR_TENTRA_API_KEY en la configuración generada, recarga tu IDE y pregúntale a tu agente:

Index this codebase with Tentra and list the god-nodes

A partir de aquí, cada git commit dispara una reindexación en segundo plano. Tus agentes se mantienen actualizados automáticamente.

Omitir el hook: usa --hook — solo escribe las configuraciones del IDE. Instalación manual stdio: npx tentra-mcp (abre el navegador para la autenticación de flujo de dispositivo de GitHub en la primera llamada a la herramienta). Usar clave API: npx tentra-mcp --key YOUR_API_KEY.

Related MCP server: codecortex

¿Qué es Tentra?

Tentra es la capa de memoria persistente para agentes de codificación de IA. Describe un sistema — obtén un diagrama y exportaciones de código para 14 frameworks. Indexa tu repositorio — los agentes consultan un grafo estructurado de archivos, símbolos, importaciones y bordes de llamadas en lugar de volver a buscar en el código fuente cada sesión.

Este servidor MCP le da a tu asistente de IA 32 herramientas:

Arquitectura (9 herramientas)

Grafo de código — Escritura (4 herramientas)

Grafo de código — Lectura (10 herramientas)

Enriquecimiento — Contratos, Decisiones, Propiedad, Dominios (9 herramientas)

Configuración

Opción 1: SSE (instalación cero)

Añadir a la configuración MCP de tu IDE — no se requiere instalación local:

Cursor (Configuración > Características > MCP > Añadir servidor):

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

Claude Code (.mcp.json en la raíz del proyecto):

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

Opción 2: Instalación local (necesaria para el escaneo de la base de código)

npx tentra-mcp

Se autentica automáticamente a través de GitHub en el primer uso. Las credenciales se guardan en ~/.tentra/credentials.

Configuración de Cursor para servidor local:

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

Claude Code (.mcp.json):

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

Ejemplos de uso

Una vez conectado, simplemente habla con tu IA:

"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

Formatos de exportación

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

Enlaces

• Sitio web: trytentra.com

• Documentación: trytentra.com/docs

• Guía de configuración: trytentra.com/docs/setup

• Galería: trytentra.com/gallery

Desarrollo

Este repositorio contiene el servidor MCP de código abierto. La API de Tentra y la aplicación web son un servicio alojado por separado en 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

El paquete npm publicado (tentra-mcp) solo envía el dist/ empaquetado — el código fuente está aquí para fines de auditoría y contribuciones de la comunidad.

Licencia

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