企业架构模型分析工具

该工具为Sparx Enterprise Architect提供混合MCP集成,支持在macOS上进行跨平台模型分析和查询,适用于企业架构师和开发人员。

  • by hdjebar
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hdjebar/ea-mcp-toolkit

使用说明

ea-mcp工具包

混合MCP集成 Sparx企业架构师 上 macOS --将Windows VM(VMware Fusion)与本机跨平台模型分析相结合。

在Mac上使用Claude Desktop或Claude Code在Sparx EA中查询、验证和创建ArchiMate/UML/BPMN模型,而无需离开macOS。

建筑

┌─ macOS (Apple Silicon / Intel) ───────────────────────────────┐
│                                                                │
│  Claude Desktop / Claude Code                                  │
│       │ STDIO            │ STDIO                               │
│       ▼                  ▼                                     │
│  ┌──────────────┐  ┌──────────────────┐                       │
│  │ EA SQLite    │  │ SSH Bridge Proxy  │                       │
│  │ Analyzer     │  │                  │──── SSH ────┐          │
│  │ (native)     │  └──────────────────┘             │          │
│  └──────┬───────┘                                   ▼          │
│         │                              ┌────────────────────┐  │
│         ▼                              │ Windows 11 ARM VM  │  │
│    .qea file ◄─────────────────────────│ Sparx EA + MCP3.exe│  │
│    (SQLite)     shared folder          └────────────────────┘  │
└────────────────────────────────────────────────────────────────┘

包含内容

目录 目录
mcp-servers/ 两台MCP服务器+一个命令安装程序
vm-setup/ 脚本化VMware Fusion+Windows 11+EA安装
docs/ 架构决策记录(MADR v4.0.0)

快速开始

1.设置Windows虚拟机(如果您需要EA的写访问权限)

cd vm-setup
chmod +x *.sh
./01-setup-vmware-fusion.sh   # Check prerequisites
./02-create-win11-vm.sh       # Create VM with autounattend
# Boot the VM, let Windows install unattended
./03-post-install.sh          # Install EA, configure MCP, create snapshot

2.在macOS上安装MCP服务器

cd mcp-servers
chmod +x install-mcp-servers.sh
./install-mcp-servers.sh

这将自动为两台服务器配置Claude Desktop和/或Claude Code。

3.与Claude一起使用

You: "Analyze the model at ~/models/architecture.qea"
You: "Show all ArchiMate application components and their dependencies"
You: "Trace the impact of retiring the Legacy CRM — 3 hops"
You: "Validate all ArchiMate relationships in the model"
You: "Create a Business Process called 'Order Fulfillment' in EA"

克劳德技能

此工具包旨在与 克劳德定制技能 --特定于域的指令,扩展了Claude在通过MCP与EA模型交互时的行为。

  • 企业架构技能 --涵盖了ArchiMate 3.2、BPMN 2.0、TOGAF、UML、C4和50多个EA框架。与此工具包结合使用时,Claude可以直接从实时EA模型数据中生成图表、ADR、ATAM评估和影响分析。

  • 定制Sparx EA MCP --该工具包为构建 根据特定的Sparx EA存储库或组织环境量身定制的完全定制的MCP服务器,通过任何LLM实现EA模型的自然语言探索和集成:

    • 以纯语言查询存储库: “哪些BPMN流程引用ConnectionRequest业务对象?” 或 “显示没有指定所有者的所有应用程序组件”
    • 在不了解EA UI的情况下浏览模型:通过描述您要查找的内容来浏览包、图表、元素和关系
    • 通过对话验证治理规则: “所有ArchiMate关系都输入正确吗?”, “标记BPMN进程缺少车道分配”
    • 根据需求生成架构工件:直接从模型数据生成ADR、影响分析、可追溯性矩阵
    • 通过自然语言编排将EA与外部系统集成:通过LLM中介从CI/CD管道、wiki或票务工具触发EA查询
    • 使MCP工具定义适应特定领域的词汇表(例如,用于能源分配的IEC 61968、用于银行业的BIAN、用于医疗保健的HL7/➤),以便LLM使用组织的语言,而不是通用的EA术语

两台MCP服务器

服务器 在上运行 需要VM吗? 阅读 写作 最适合
EA模型分析器 macOS(本机) 否 ✅ ❌ 离线分析、验证、统计、影响追踪
Sparx EA大桥 macOS→ SSH → VM 是 ✅ ✅ 实时CRUD、图表导出、元素创建

SQLite分析器以零启动时间处理常见情况(只读查询、验证、报告)。当您需要写操作时,SSH桥通过官方的Sparx Japan MCP服务器提供完整的EA交互。

需求

  • macOS 13+(苹果硅或英特尔)
  • Python 3.10+
  • 紫外线 (推荐)或pip
  • VMware Fusion 13.5+(个人免费使用)-仅用于写访问
  • Sparx EA许可证——仅用于写访问

文档

相关

  • SparxEA -通过EA Interop API实现PowerShell/Python自动化。补充此仓库:SparxEA写入并填充仓库;ea-mcp工具包通过SQLite和mcp读取、查询和验证它。

许可证

麻省理工学院