Enterprise Architect MCP Server

Sparx Enterprise Architect の .qea エクスポート用の読み取り専用 MCP サーバーです。実行中の EA インスタンスを必要とせず、AI エージェントに 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" }（空の結果とは区別されます）

不正確な回答が確認済みの回答として扱われるのを防ぐための 2 つのフィールド：

• 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 はどの図に表示されている？」