Enterprise Architect MCP Server

A read-only MCP server for Sparx Enterprise Architect .qea exports. Gives AI agents access to EA analysis models — search elements, navigate packages, read use case scenarios, and traverse connectors — without a running EA instance.

Prerequisites

• Node.js 22+ (uses the built-in node:sqlite module)

• A .qea file exported from Sparx Enterprise Architect

Installation

Add to your project's .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>"
      }
    }
  }
}

Replace <path-to-your-qea-file-or-directory> with your actual .qea file path.

Configuration

The server resolves the .qea path using a fallback chain (first match wins):

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

2. Environment variable — EA_QEA_PATH (set in mcp.json env block or system env)

3. .env file — EA_QEA_PATH=... in a .env file in the working directory

If the path points to a directory, the server automatically picks the newest .qea file by modification time.

Setup with .env (recommended for teams)

# Copy the template
cp .env.example .env

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

The .env file is gitignored — each developer sets their own path without affecting the shared config.

Available Tools

Response contract

Every tool returns structured JSON with:

• _meta.sourceTables — which database tables were consulted

• totalMatched / returned / truncated — completeness metadata on every collection

• continuation — exact call to retrieve the full set when truncated

• isError: true + { error: "not_found" } for non-existent subjects (distinct from empty results)

Two fields exist to stop an inexact answer from being read as a confirmed one:

• ea_resolve — match is always present; only prefix is an inexact match

• ea_get_element — _meta.attributes.multiplicityIsUniform: true means the element's attributes show no multiplicity contrast, so 1..1 is not evidence of requiredness

Example Prompts

Once connected, try prompts like:

• "Search for elements related to 'právnická osoba'"

• "Show me the package structure under the root"

• "What are the use case scenarios for UC_FEO_2027?"

• "What elements and connectors are on diagram 0103 Spracovanie eFORM?"

• "Resolve the reference {94291B11-C990-482e-BF3F-19EFF04FB37E}"

• "What columns does t_connector have?"

• "Which diagrams does element a7680 appear on?"