Enterprise Architect MCP Server

Ein schreibgeschützter MCP-Server für Sparx Enterprise Architect .qea-Exporte. Gibt KI-Agenten Zugriff auf EA-Analysemodelle – Elemente suchen, Pakete navigieren, Anwendungsfallszenarien lesen und Verbindungen durchlaufen – ohne eine laufende EA-Instanz.

Voraussetzungen

• Node.js 22+ (verwendet das eingebaute node:sqlite-Modul)

• Eine aus Sparx Enterprise Architect exportierte .qea-Datei

Installation

Fügen Sie Folgendes zu .vscode/mcp.json Ihres Projekts hinzu:

{
  "servers": {
    "enterprise-architect": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:DITEC-Mracka/enterprise-architect-mcp"],
      "env": {
        "EA_QEA_PATH": "<path-to-your-qea-file-or-directory>"
      }
    }
  }
}

Ersetzen Sie <path-to-your-qea-file-or-directory> durch den tatsächlichen Pfad zu Ihrer .qea-Datei.

Konfiguration

Der Server löst den .qea-Pfad über eine Fallback-Kette auf (erster Treffer gewinnt):

1. CLI-Argument — mcp-server-ea C:\path\to\model.qea

2. Umgebungsvariable — EA_QEA_PATH (gesetzt im env-Block von mcp.json oder als Systemvariable)

3. .env-Datei — EA_QEA_PATH=... in einer .env-Datei im Arbeitsverzeichnis

Wenn der Pfad auf ein Verzeichnis zeigt, wählt der Server automatisch die neueste .qea-Datei anhand des Änderungszeitpunkts aus.

Einrichtung mit .env (für Teams empfohlen)

# Copy the template
cp .env.example .env

# Edit .env with your local path
EA_QEA_PATH=D:\EAExporty\projekt\architektura.qea

Die .env-Datei ist gitignored – jeder Entwickler setzt seinen eigenen Pfad, ohne die gemeinsame Konfiguration zu beeinflussen.

Verfügbare Tools

Antwortvertrag

Jedes Tool gibt strukturiertes JSON zurück mit:

• _meta.sourceTables — welche Datenbanktabellen konsultiert wurden

• totalMatched / returned / truncated — Vollständigkeitsmetadaten für jede Sammlung

• continuation — genauer Aufruf, um den vollständigen Satz abzurufen, wenn abgeschnitten

• isError: true + { error: "not_found" } für nicht vorhandene Subjekte (unterscheidet sich von leeren Ergebnissen)

Zwei Felder verhindern, dass eine ungenaue Antwort als bestätigt gelesen wird:

• ea_resolve — match ist immer vorhanden; nur prefix ist ein ungenauer Treffer

• ea_get_element — _meta.attributes.multiplicityIsUniform: true bedeutet, dass die Attribute des Elements keinen Multiplizitätskontrast zeigen, also 1..1 kein Beleg für Erforderlichkeit ist

Beispiel-Prompts

Sobald verbunden, versuchen Sie Prompts wie:

• "Suche nach Elementen, die mit 'právnická osoba' zusammenhängen"

• "Zeig mir die Paketstruktur unter dem Root"

• "Was sind die Anwendungsfallszenarien für UC_FEO_2027?"

• "Welche Elemente und Verbindungen sind auf Diagramm 0103 Spracovanie eFORM?"

• "Löse die Referenz {94291B11-C990-482e-BF3F-19EFF04FB37E} auf"

• "Welche Spalten hat t_connector?"

• "Auf welchen Diagrammen erscheint Element a7680?"