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 snapshot2.在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许可证——仅用于写访问
文档
- ADR-0001：混合MCP集成 --完整的架构决策记录，包括基本原理、权衡和组件清单
- VM安装指南 --脚本化Windows 11+EA安装
- MCP服务器指南 --服务器配置和使用
相关
- SparxEA -通过EA Interop API实现PowerShell/Python自动化。补充此仓库：SparxEA写入并填充仓库；ea-mcp工具包通过SQLite和mcp读取、查询和验证它。
许可证
麻省理工学院