Enterprise Architect MCP Server

用于 Sparx Enterprise Architect .qea 导出的只读 MCP 服务器。让 AI 代理能够访问 EA 分析模型——搜索元素、导航包、读取用例场景以及遍历连接器——而无需运行 EA 实例。

先决条件

• Node.js 22+（使用内置的 node:sqlite 模块）

• 从 Sparx Enterprise Architect 导出的 .qea 文件

安装

添加到项目的 .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. CLI 参数 —— mcp-server-ea C:\path\to\model.qea

2. 环境变量 —— EA_QEA_PATH（在 mcp.json 的 env 块或系统环境中设置）

3. .env 文件 —— 在工作目录的 .env 文件中设置 EA_QEA_PATH=...

如果路径指向目录，服务器会自动按修改时间选择最新的 .qea 文件。

使用 .env 进行设置（推荐团队使用）

# Copy the template
cp .env.example .env

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

.env 文件已被 gitignore——每位开发者设置自己的路径，不会影响共享配置。

可用工具

响应契约

每个工具都返回结构化 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 出现在哪些图表上？"