Enterprise Architect MCP Server

Un servidor MCP de solo lectura para exportaciones .qea de Sparx Enterprise Architect. Da a los agentes de IA acceso a modelos de análisis de EA: buscar elementos, navegar paquetes, leer escenarios de casos de uso y recorrer conectores, sin necesidad de una instancia de EA en ejecución.

Requisitos previos

• Node.js 22+ (usa el módulo integrado node:sqlite)

• Un archivo .qea exportado desde Sparx Enterprise Architect

Instalación

Añádelo al .vscode/mcp.json de tu proyecto:

{
  "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>"
      }
    }
  }
}

Reemplaza <path-to-your-qea-file-or-directory> con la ruta real de tu archivo .qea.

Configuración

El servidor resuelve la ruta .qea mediante una cadena de respaldo (gana la primera coincidencia):

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

2. Variable de entorno — EA_QEA_PATH (definida en el bloque env de mcp.json o en el entorno del sistema)

3. Archivo .env — EA_QEA_PATH=... en un archivo .env en el directorio de trabajo

Si la ruta apunta a un directorio, el servidor selecciona automáticamente el archivo .qea más reciente por fecha de modificación.

Configuración con .env (recomendado para equipos)

# Copy the template
cp .env.example .env

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

El archivo .env está en gitignore: cada desarrollador define su propia ruta sin afectar a la configuración compartida.

Herramientas disponibles

Contrato de respuesta

Cada herramienta devuelve JSON estructurado con:

• _meta.sourceTables — qué tablas de base de datos se consultaron

• totalMatched / returned / truncated — metadatos de completitud en cada colección

• continuation — llamada exacta para recuperar el conjunto completo cuando se trunca

• isError: true + { error: "not_found" } para sujetos inexistentes (distinto de resultados vacíos)

Existen dos campos para evitar que una respuesta inexacta se lea como confirmada:

• ea_resolve — match siempre está presente; solo prefix es una coincidencia inexacta

• ea_get_element — _meta.attributes.multiplicityIsUniform: true significa que los atributos del elemento no muestran contraste de multiplicidad, por lo que 1..1 no es evidencia de obligatoriedad

Ejemplos de indicaciones

Una vez conectado, prueba indicaciones como:

• "Busca elementos relacionados con 'právnická osoba'"

• "Muéstrame la estructura de paquetes bajo la raíz"

• "¿Cuáles son los escenarios de caso de uso para UC_FEO_2027?"

• "¿Qué elementos y conectores hay en el diagrama 0103 Spracovanie eFORM?"

• "Resuelve la referencia {94291B11-C990-482e-BF3F-19EFF04FB37E}"

• "¿Qué columnas tiene t_connector?"

• "¿En qué diagramas aparece el elemento a7680?"