tentra-mcp

npm version npm downloads License: MIT

Speicher für KI-Coding-Agenten. Persistenter Code-Graph + KI-generierte Architekturdiagramme — MCP-nativ. Funktioniert in Cursor, Claude Code, Codex und Windsurf.

Dogfood-Benchmark in unserem eigenen Monorepo: 99,4 % Token-Reduzierung (156,8-faches Verhältnis) bei 8 „Wo ist X implementiert?“-Abfragen — 114.644 Token durch erneutes Lesen von Dateien gegenüber 731 Token durch query_symbols. Vollständiger Bericht →

Schnelleinstieg

npx tentra-mcp

Bei der ersten Verwendung öffnet sich Ihr Browser für die GitHub-Anmeldung mit einem Klick. Das ist alles — kein API-Schlüssel erforderlich.

Fortgeschritten: Wenn Sie lieber direkt einen API-Schlüssel verwenden möchten, führen Sie npx tentra-mcp --key YOUR_API_KEY aus. Ihren Schlüssel erhalten Sie unter trytentra.com/settings.

Was ist Tentra?

Tentra ist die persistente Speicherschicht für KI-Coding-Agenten. Beschreiben Sie ein System — erhalten Sie ein Diagramm und Code-Exporte für 14 Frameworks. Indizieren Sie Ihr Repository — Agenten fragen einen strukturierten Graphen aus Dateien, Symbolen, Importen und Aufruf-Kanten ab, anstatt bei jeder Sitzung den Quellcode neu zu durchsuchen.

Dieser MCP-Server bietet Ihrem KI-Assistenten 32 Tools:

Architektur (9 Tools)

Tool	Beschreibung
`create_architecture`	Entwurf eines neuen Systems basierend auf einer Beschreibung
`update_architecture`	Änderung einer bestehenden Architektur
`get_architecture`	Lesen von Architekturdetails
`list_architectures`	Durchsuchen aller gespeicherten Entwürfe
`analyze_codebase`	Scannen des lokalen Codes und Generieren eines Diagramms
`lint_architecture`	Qualitätsprüfungen (9 Regeln: Waisen, SPOFs, Gott-Services)
`sync_architecture`	Erkennung von Abweichungen zwischen Diagramm und Code
`export_architecture`	Export in 14 Frameworks (Java, Python, Go, Rust, etc.)
`create_flow`	Erstellung einer schrittweisen Ablaufvisualisierung

Code-Graph — Schreiben (4 Tools)

Tool	Beschreibung
`index_code`	Durchlaufen eines Repos, lokales Tree-sitter, Start eines semantischen Indizierungsauftrags
`index_code_continue`	Fortsetzen eines laufenden Indizierungsauftrags
`record_semantic_node`	Persistieren einer vom Agenten extrahierten semantischen Annotation
`get_index_job`	Statusprüfung eines Indizierungsauftrags

Code-Graph — Lesen (10 Tools)

Tool	Beschreibung
`query_symbols`	Fuzzy-Trigramm-Suche über indizierte Symbole
`get_symbol_neighbors`	BFS-Durchlauf im Aufruf-/Import-Graphen
`get_service_code_graph`	Subgraph für einen Canvas-Service
`explain_code_path`	Kürzester Pfad zwischen zwei Symbolen mit semantischem Kontext
`find_similar_code`	pgvector Kosinus-ANN über vom Agenten generierte Embeddings
`record_embedding`	Persistieren eines vom Agenten generierten Embedding-Vektors
`list_god_nodes`	Symbole mit höchstem Fan-in/out (architektonische Schwachstellen)
`get_quality_hotspots`	Ranking nach Churn × Komplexität
`list_snapshots`	Zeitreise-Auflistung indizierter Snapshots
`diff_snapshots`	Dateien / Symbole / Gott-Knoten, die zwischen Snapshots hinzugefügt/entfernt wurden

Anreicherung — Verträge, Entscheidungen, Eigentum, Domänen (9 Tools)

Tool	Beschreibung
`set_service_mapping`	Verknüpfung einer indizierten Datei oder eines Symbols mit einem Canvas-Service
`set_domain_membership`	Zuweisung eines Service oder einer Datei zu einer Domäne (Bounded Context)
`record_contract`	Speichern einer geparsten API-Vertrags-Payload (OpenAPI, GraphQL, Protobuf)
`bind_contract`	Verknüpfung eines Vertrags mit dem Symbol, das ihn implementiert
`record_decision`	Erstellung eines Architektur-Entscheidungsdatensatzes (ADR), optional mit Code-Verknüpfung
`link_decision`	Hinzufügen eines Links von einem ADR zu einem anderen Symbol, einer Datei oder einem Service
`get_ownership`	Ermittlung des Eigentümers (Team oder Person) für eine Datei oder einen Service
`get_decisions_for`	Auflistung der ADRs, die mit einer bestimmten Entität verknüpft sind
`get_contracts`	Auflistung von Verträgen, optional gefiltert nach Typ oder Service

Einrichtung

Option 1: SSE (keine Installation)

Fügen Sie dies zur MCP-Konfiguration Ihrer IDE hinzu — keine lokale Installation erforderlich:

Cursor (Einstellungen > Features > MCP > Server hinzufügen):

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

Claude Code (.mcp.json im Projektstammverzeichnis):

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

Option 2: Lokale Installation (erforderlich für das Scannen der Codebasis)

npx tentra-mcp

Authentifiziert sich bei der ersten Verwendung automatisch über GitHub. Anmeldedaten werden unter ~/.tentra/credentials gespeichert.

Cursor-Konfiguration für lokalen Server:

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

Claude Code (.mcp.json):

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

Anwendungsbeispiele

Sobald die Verbindung hergestellt ist, sprechen Sie einfach mit Ihrer KI:

"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

Exportformate

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

Entwicklung

Dieses Repository enthält den Open-Source-MCP-Server. Die Tentra-API und die Web-App sind ein separater gehosteter Dienst unter 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

Das veröffentlichte npm-Paket (tentra-mcp) enthält nur das gebündelte dist/ — der Quellcode ist hier zur Überprüfbarkeit und für Community-Beiträge verfügbar.

Lizenz

MIT

tentra