Java 微服务项目应用架构制品自动生成工具(TOGAF AA 系列 / MCP Server / 开源)
0你遇到这种场景吗周一早会项目经理说甲方把源码给过来了20 个微服务2 周内要全套应用架构制品——模块清单、功能项清单、集成关系图、架构总览图TOGAF 标准Excel PPT。你打开项目一看17 个 Maven 模块264 个 Java 文件Spring Cloud 全家桶Feign 调用关系一堆。接下来你要做的事1. 逐个模块翻代码找 Controller、Service、Repository2. 手动统计每个模块有哪些 API Endpoint3. 找 FeignClient 接口理清模块间调用关系4. 打开 Excel一行一行填应用模块清单AG-001、AG-002……别填重了5. 打开 Excel 另一个 Sheet一行一行填功能项AF-001 到 AF-129……6. 打开 PPT画架构分层图对齐模块框拉连接线7. 再画一张集成关系图实际工作量17 个模块 × 平均 2 小时 34 小时。加上核对、格式调整、画图一个人全力干至少 1 周。这活没技术含量但就是费时间。而且每接一个新项目全部重来一遍。1现在有个工具能把这 1 周压到 30 秒architecture-discovery-mcp 做的事情很简单你给它一个 Java/Maven 项目路径它自动扫描源码直接输出 TOGAF 标准的 AA 系列制品。- 7 个制品一次性生成模块清单、功能项清单、子功能清单、功能分布、集成清单、应用架构图、应用集成图- Excel5 个 Sheet 2 个 PPTX可以直接放进交付文档- 全程本地运行代码不出域不用担心安全合规它是一个 MCP Server配合 Claude Code / Cursor / VS Code 使用——用自然语言告诉 AI 扫描这个项目制品就出来了。2实操演示Ruoyi-cloud全过程拿国内最流行的Spring Cloud微服务脚手架Ruoyi-Cloud做演示。a) 安装一行命令pip install architecture-discovery-mcpb) 配置加入到你的AI IDEClaude Code~/.claude.json{mcpServers: {architecture-discovery: {command: architecture-discovery-mcp}}}Cursor.cursor/mcp.json或 VS Code.vscode/settings.json配置类似。c) 使用对 AI 说一句话 扫描 D:/projects/ruoyi-cloud 项目生成应用架构制品输出到 D:/output30秒后结果出来了✅ 扫描完成模块17 个API Endpoints129 个集成关系3 条 生成制品application-architecture.xlsx5 个 SheetAA-07_应用架构图.pptxAA-08_应用集成图.pptx3看看交付了什么a) Excel 制品5 个 Sheet开箱即用一个excel文件包含5个标准制品Sheet打开就能交付i) AA-01 模块清单 AA-01 应用系统模块清单自动按「应用域 → 应用组 → 一级模块」三层展开17 个模块全覆盖编码连续不重复。ii)AA-02 功能项清单:AA-02 功能项清单 129 个 API 全部提取一个不漏。方法名、HTTP 动词、完整路径直接对应业务功能。iiii)AA-03功能子项清单iiii)AA-04功能项分布清单iiiii)AA-05应用集成清单iiiiii)AA-07应用架构图iiiiiii)AA-08应用集成图4) 省了什么算笔账维度手工梳理自动发现引擎耗时1-2周30秒覆盖度取决于人的耐心容易遗漏全量扫描129个API一个不漏编码规范手工编号容易跳号/重复自动连续编码可重复每个项目重新来一遍换个路径重新跑一致性不同人填的格式不同模板固定输出标准统一维护代码更新后需手工同步重新扫描即最新省出来的时间拿来做什么做真正需要判断力的事-业务语义标注、架构合理性评估、优化建议。工具出初稿人工定终稿。5谁适合用a) 架构咨询顾问甲方给源码要制品这是你的出活利器b) 企业架构师维护架构资产库不再用手工更新c) 技术leader: 接手陌生系统30分钟建立全局认知d) 任何需要做Java微服务架构梳理的人6多语言支持制品支持中英文切换 Scan ruoyi-cloud and generate architecture artifacts in English英文版表头、层名、图标题全部切换适合外企客户或国际团队交付。7开始使用pip install architecture-discovery-mcpGitHub[https://github.com/rdtan/architecture-discovery-mcp]支持 Java/Maven、Spring Boot、Spring Cloud 微服务项目。觉得有用给个 Star或提个 Issue 告诉我你希望支持什么项目类型。8)一起聊聊我建了一个「EA 制品自动化」交流群目前在做的事a)分享架构制品自动化的实战经验和踩坑b) 收集大家实际项目中遇到的框架和制品需求优先排进开发计划c) 工具使用问题实时答疑如果你也在做架构梳理、企业架构咨询或者对 MCP EA 这个方向感兴趣欢迎加入公众号回复「架构工具」获取入群方式。下期预告数据架构制品DA 系列自动生成从 Entity/ER 关系到数据流转图敬请期待。