0）你遇到这种场景吗？

周一早会，项目经理说："甲方把源码给过来了，20 个微服务，2 周内要全套应用架构制品——模块清单、功能项清单、集成关系图、架构总览图，TOGAF 标准，Excel + PPT。"

你打开项目一看：17 个 Maven 模块，264 个 Java 文件，Spring Cloud 全家桶，Feign 调用关系一堆。

接下来你要做的事：

1. 逐个模块翻代码，找 Controller、Service、Repository

2. 手动统计每个模块有哪些 API Endpoint

3. 找 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 个制品一次性生成：模块清单、功能项清单、子功能清单、功能分布、集成清单、应用架构图、应用集成图

- Excel（5 个 Sheet）+ 2 个 PPTX，可以直接放进交付文档

- 全程本地运行，代码不出域，不用担心安全合规

它是一个 MCP Server，配合 Claude Code / Cursor / VS Code 使用——用自然语言告诉 AI "扫描这个项目"，制品就出来了。

2）实操演示：Ruoyi-cloud全过程

拿国内最流行的Spring Cloud微服务脚手架Ruoyi-Cloud做演示。

a) 安装（一行命令）

pip install architecture-discovery-mcp

b) 配置（加入到你的AI IDE）

Claude 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:/output"

30秒后，结果出来了：

✅ 扫描完成

模块：17 个

API Endpoints：129 个

集成关系：3 条

📦 生成制品：

application-architecture.xlsx（5 个 Sheet）

AA-07_应用架构图.pptx

AA-08_应用集成图.pptx

3）看看交付了什么

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) 省了什么？算笔账

省出来的时间拿来做什么？做真正需要判断力的事-业务语义标注、架构合理性评估、优化建议。工具出初稿，人工定终稿。

5）谁适合用？

a) 架构咨询顾问：甲方给源码要制品，这是你的出活利器

b) 企业架构师：维护架构资产库，不再用手工更新

c) 技术leader: 接手陌生系统，30分钟建立全局认知

d) 任何需要做Java微服务架构梳理的人

6）多语言支持

制品支持中英文切换：

> "Scan ruoyi-cloud and generate architecture artifacts in English"

英文版表头、层名、图标题全部切换，适合外企客户或国际团队交付。

7）开始使用

pip install architecture-discovery-mcp

GitHub：[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 关系到数据流转图，敬请期待。