Сервер Enterprise Architect MCP

Сервер MCP только для чтения для экспортов Sparx Enterprise Architect .qea. Предоставляет AI-агентам доступ к аналитическим моделям EA — поиск элементов, навигация по пакетам, чтение сценариев вариантов использования и обход соединителей — без запущенного экземпляра EA.

Предварительные требования

• Node.js 22+ (использует встроенный модуль node:sqlite)

• Файл .qea, экспортированный из Sparx Enterprise Architect

Установка

Добавьте в файл .vscode/mcp.json вашего проекта:

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

Замените <path-to-your-qea-file-or-directory> на фактический путь к вашему файлу .qea.

Конфигурация

Сервер определяет путь к .qea, используя цепочку резервных вариантов (первый совпавший выигрывает):

1. Аргумент командной строки — mcp-server-ea C:\path\to\model.qea

2. Переменная окружения — EA_QEA_PATH (задаётся в блоке env в mcp.json или в системном окружении)

3. Файл .env — EA_QEA_PATH=... в файле .env в рабочем каталоге

Если путь указывает на каталог, сервер автоматически выбирает самый новый файл .qea по времени изменения.

Настройка с помощью .env (рекомендуется для команд)

# Copy the template
cp .env.example .env

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

Файл .env игнорируется git — каждый разработчик задаёт свой путь, не влияя на общую конфигурацию.

Доступные инструменты

Контракт ответа

Каждый инструмент возвращает структурированный JSON со следующими полями:

• _meta.sourceTables — какие таблицы базы данных были задействованы

• totalMatched / returned / truncated — метаданные полноты для каждой коллекции

• continuation — точный вызов для получения полного набора при усечении

• isError: true + { error: "not_found" } для несуществующих объектов (отличается от пустых результатов)

Два поля существуют, чтобы неточный ответ не был воспринят как подтверждённый:

• ea_resolve — match всегда присутствует; только prefix является неточным совпадением

• ea_get_element — _meta.attributes.multiplicityIsUniform: true означает, что атрибуты элемента не показывают контраста множественности, поэтому 1..1 не является свидетельством обязательности

Примеры запросов

После подключения попробуйте такие запросы:

• "Найти элементы, связанные с 'právnická osoba'"

• "Показать структуру пакетов в корневом каталоге"

• "Какие сценарии вариантов использования для UC_FEO_2027?"

• "Какие элементы и соединители находятся на диаграмме 0103 Spracovanie eFORM?"

• "Разрешить ссылку {94291B11-C990-482e-BF3F-19EFF04FB37E}"

• "Какие столбцы есть в t_connector?"

• "На каких диаграммах присутствует элемент a7680?"