rdtan/architecture-discovery-mcp
GitHub: rdtan/architecture-discovery-mcp
该工具通过 MCP 服务器对 Java/Maven 源码进行静态分析，自动发现并生成符合 TOGAF 标准的企业应用架构与数据架构交付文档。
Stars: 4 | Forks: 0
# 架构发现引擎
从 Java/Maven 源码中自动发现企业架构产物。扫描您的项目并在几秒钟内生成符合 TOGAF 标准的应用架构交付物。
## 它的功能
将其指向一个 Java/Maven 项目，您将获得：
**应用架构 (AA)：**
- **AA-01** 应用模块清单 (Excel)
- **AA-02** 功能项清单 (Excel)
- **AA-03** 子功能清单 (Excel)
- **AA-04** 功能分布 (Excel)
- **AA-05** 集成清单 (Excel)
- **AA-07** 应用架构图 (PPTX)
- **AA-08** 应用集成图 (PPTX)
**数据架构 (DA)：**
- **DA-01** 概念实体列表 (Excel)
- **DA-02** 逻辑实体列表 (Excel)
- **DA-03** 物理实体列表 (Excel)
- **DA-04** 数据库表列表 (Excel)
- **DA-05** 数据源列表 (Excel)
- **DA-06** 表-功能关系 (Excel)
- **DA-07** 数据字典 (Excel)
- **DA-CDM** 概念数据模型图 (PPTX)
- **DA-LDM** 逻辑数据模型图 (PPTX)
- **DA-Flow** 数据流图 (PPTX)
以上所有内容均通过静态分析生成 —— 无需运行时，代码也不会离开您的机器。
## 安装
```
pip install architecture-discovery-mcp
```
需要 Python 3.11+。
## 用法
### 作为 MCP 服务器（推荐）
该引擎作为基于 stdio 的 [MCP](https://modelcontextprotocol.io/) 服务器运行。请在您的 AI IDE 中对其进行配置：
**Claude Code** (`~/.claude.json`)：
```
{
"mcpServers": {
"architecture-discovery": {
"command": "architecture-discovery-mcp"
}
}
}
```
**Cursor** (`.cursor/mcp.json`)：
```
{
"mcpServers": {
"architecture-discovery": {
"command": "architecture-discovery-mcp"
}
}
}
```
**VS Code** (`.vscode/settings.json`)：
```
{
"mcp": {
"servers": {
"architecture-discovery": {
"command": "architecture-discovery-mcp"
}
}
}
}
```
然后自然地向您的 AI 助手提问即可：
### 可用的 MCP 工具
| 工具 | 描述 |
|------|-------------|
| `scan_project_tool` | 扫描项目结构，返回模块/框架概览 |
| `generate_app_architecture_tool` | 生成完整的 AA 产物集 (Excel + PPTX) |
| `export_intermediate_data` | 将结构化分析结果导出为 JSON |
| `generate_data_architecture` | 生成完整的 DA 产物集 (Excel + PPTX) |
| `generate_tech_architecture` | TA 产物（即将推出） |
所有工具都接受可选的 `locale` 参数（`"zh"` 或 `"en"`，默认为 `"zh"`）。
### 作为 Python 库使用
```
from pathlib import Path
from src.scanner.project_scanner import scan_project
from src.analyzers.module_analyzer import analyze_modules
from src.analyzers.api_analyzer import analyze_apis
from src.analyzers.integration_analyzer import analyze_integrations
from src.generators.app_architecture_generator import generate_app_architecture
from src.generators.aa07_generator import generate_aa07
from src.generators.aa08_generator import generate_aa08
project = scan_project(Path("your-java-project"))
project = analyze_modules(project)
endpoints = analyze_apis(project)
integrations = analyze_integrations(project)
out = Path("output")
generate_app_architecture(project, endpoints, integrations, out, locale="en")
generate_aa07(project, out, locale="en")
generate_aa08(project, integrations, out, locale="en")
```
### 数据架构生成
```
from src.analyzers.data_entity_analyzer import analyze_data_entities
from src.analyzers.enum_analyzer import analyze_enums
from src.analyzers.crud_analyzer import analyze_crud
from src.generators.da_combined_generator import generate_all_da
project = scan_project(Path("your-java-project"))
project = analyze_modules(project)
endpoints = analyze_apis(project)
entities = analyze_data_entities(project)
enums = analyze_enums(project)
crud_records = analyze_crud(entities, endpoints)
generate_all_da(project, entities, enums, crud_records, out, locale="en")
```
## 支持的项目
- Java/Maven 项目（必须包含 `pom.xml`）
- Spring Boot / Spring Cloud 微服务
- Feign client 集成检测
- JPA 实体检测（@Entity、@Table、@Column）
- MyBatis mapper XML 解析
- Enum 扫描与数据字典生成
- 嵌套的多模块项目（例如 RuoYi-Cloud 风格）
## 国际化
生成的产物可以是中文（`locale="zh"`，默认）或英文（`locale="en"`）。此设置控制：
- Excel 列标题和工作表名称
- 单元格值（层名称、状态标签）
- PPTX 幻灯片标题和图表标签
- 字体选择（中文使用微软雅黑，英文使用 Calibri）
## 安全性
- 通过 stdio 在本地运行 —— 无网络暴露
- 源代码永远不会离开您的机器
- 导出的 JSON 仅包含结构化元数据（类名、API 路径、注解），不包含源代码
## 开发
```
git clone
cd architecture-discovery-engine
pip install -e ".[dev]"
pytest tests/ -v
```
## 许可证
MIT
标签：MCP Server, TOGAF, 云安全监控, 代码分析, 企业架构, 凭证管理, 逆向工具, 静态分析