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은 어떤 다이어그램에 나타나나요?"