tentra-mcp

npm version npm downloads License: MIT

Memoria para agentes de programació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 tipo "¿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

npx tentra-mcp

En el primer uso, se abrirá tu navegador para iniciar sesión en GitHub con un solo clic. Eso es todo, no se necesita clave de API.

Avanzado: Si prefieres usar una clave de API directamente, ejecuta npx tentra-mcp --key TU_CLAVE_API. Obtén tu clave en trytentra.com/settings.

¿Qué es Tentra?

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

Este servidor MCP proporciona a tu asistente de IA 32 herramientas:

Arquitectura (9 herramientas)

Herramienta	Descripción
`create_architecture`	Diseñar un nuevo sistema a partir de una descripción
`update_architecture`	Modificar una arquitectura existente
`get_architecture`	Leer detalles de la arquitectura
`list_architectures`	Explorar todos los diseños guardados
`analyze_codebase`	Escanear código local y generar un diagrama
`lint_architecture`	Comprobaciones de calidad (9 reglas: huérfanos, SPOFs, servicios "dios")
`sync_architecture`	Detectar desviaciones entre el diagrama y el código
`export_architecture`	Exportar a 14 frameworks (Java, Python, Go, Rust, etc.)
`create_flow`	Crear una visualización de flujo paso a paso

Grafo de código — Escritura (4 herramientas)

Herramienta	Descripción
`index_code`	Recorrer un repositorio, usar Tree-sitter localmente, iniciar un trabajo de indexación semántica
`index_code_continue`	Reanudar un trabajo de indexación en curso
`record_semantic_node`	Persistir una anotación semántica extraída por el agente
`get_index_job`	Comprobar el estado de un trabajo de indexación

Grafo de código — Lectura (10 herramientas)

Herramienta	Descripción
`query_symbols`	Búsqueda difusa de trigramas en símbolos indexados
`get_symbol_neighbors`	Recorrido BFS en el grafo de llamadas/importaciones
`get_service_code_graph`	Subgrafo para un servicio de lienzo
`explain_code_path`	Camino más corto entre dos símbolos con contexto semántico
`find_similar_code`	ANN de coseno pgvector sobre embeddings generados por el agente
`record_embedding`	Persistir un vector de embedding generado por el agente
`list_god_nodes`	Símbolos con mayor fan-in/out (olores arquitectónicos)
`get_quality_hotspots`	Clasificación por rotación × complejidad
`list_snapshots`	Listado de instantáneas indexadas con viaje en el tiempo
`diff_snapshots`	Archivos / símbolos / nodos "dios" añadidos/eliminados entre instantáneas

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

Herramienta	Descripción
`set_service_mapping`	Vincular un archivo o símbolo indexado a un servicio de lienzo
`set_domain_membership`	Asignar un servicio o archivo a un dominio (contexto delimitado)
`record_contract`	Almacenar una carga útil de contrato de API analizada (OpenAPI, GraphQL, Protobuf)
`bind_contract`	Vincular un contrato al símbolo que lo implementa
`record_decision`	Crear un Registro de Decisiones de Arquitectura (ADR), vinculando opcionalmente el código
`link_decision`	Añadir un enlace desde un ADR a otro símbolo, archivo o servicio
`get_ownership`	Resolver el propietario (equipo o persona) de un archivo o servicio
`get_decisions_for`	Listar ADRs vinculados a una entidad dada
`get_contracts`	Listar contratos, filtrados opcionalmente por tipo o servicio

Configuración

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

Añádelo 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 incluye el dist/ empaquetado — el código fuente está aquí para fines de auditoría y contribuciones de la comunidad.

Licencia

MIT

tentra