UML Forge

Name: UML Forge
Author: dave1362

本地服务

github.com/dave1362开发工具02 周前更新

代码仓库

关于 UML Forge

UML Forge 是面向编码 Agent 的 MCP 服务，可将代码库、架构描述和数据库模式转换为 UML 图。工具还涵盖安全分析、团队入职文档和现有图表更新。

主要功能

01从代码逆向生成图表
02创建 API 与事件流时序图
03生成 ERD 和状态图
04建模威胁与攻击面
05根据冲刺或 PR 更新图表

适用场景

01梳理服务及请求流程
02分析架构的攻击面
03记录遗留系统迁移方案
04为团队准备入职资料

MCP 相关

它向兼容 MCP 的编码 Agent 提供 15 个图表生成与分析工具。长时间运行的任务可通过 `umlforge_get_result` 获取结果。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dave1362-umlforge": {
      "command": "uvx",
      "args": [
        "umlforge"
      ],
      "env": {
        "UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
      }
    }
  }
}

启动命令uvx umlforge

需要配置的环境变量

UMLFORGE_API_KEY密钥Your UML Forge API key — get one free at https://umlforge.dev

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiumlforge0.4.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填
codebase	string	否
max_nodes	integer	否
github_url	any	否
report_mode	boolean	否
github_token	any	否

详细介绍

UML Forge MCP Connector

在编码 Agent 中实现架构智能、安全分析和持续更新的文档。

UML Forge 为 Claude Code、Cursor、Windsurf 及任何兼容 MCP 的编码 Agent 提供一套由 15 个工具组成的工具集（14 个图表工具，另加 umlforge_get_result），用于根据代码库、架构描述或数据库架构生成专业 UML 图表。

快速开始

Claude Code：

{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": ["umlforge"],
      "env": { "UMLFORGE_API_KEY": "your-api-key" }
    }
  }
}

Cursor / Windsurf——将相同的配置块添加到 MCP 设置中。

在 umlforge.dev 获取 API 密钥。

包含的工具

工具	描述
`umlforge_suggest`	从这里开始。用通俗语言描述目标，即可获得合适的工具和可直接运行的调用
`umlforge_reverse_engineer`	根据代码库或 GitHub URL 生成类图、时序图和状态图
`umlforge_api_sequence`	生成服务间请求流程的时序图
`umlforge_erd_schema`	根据领域描述或 SQL 架构生成实体关系图
`umlforge_state_machine`	根据实体生命周期和业务规则生成状态图
`umlforge_frontend_components`	为 UI 功能生成组件层级和交互图
`umlforge_deployment`	生成基础设施和 CI/CD 流水线图
`umlforge_threat_model`	生成 STRIDE 威胁模型和攻击面图
`umlforge_event_driven`	生成事件流和发布/订阅架构图
`umlforge_ai_agent`	为大模型流水线生成 Agent 拓扑和工具调用流程图
`umlforge_stakeholder_arch`	为投资者、CTO 和非技术利益相关者生成 C4 上下文图
`umlforge_living_docs`	更新现有图表，以反映冲刺或 PR 变更
`umlforge_onboarding`	为新团队成员准备入职首日知识移交资料包
`umlforge_legacy_migration`	根据 COBOL、Fortran、ABAP、RPG 和其他旧式语言生成旧系统结构图、现代架构图和 6 阶段迁移路线图
`umlforge_get_result`	获取仍在运行的生成任务（参见长时间运行的生成任务）

所有图表工具都接受 report_mode=True，可在生成图表的同时生成书面分析报告。将 report_mode 留空，则沿用账户已保存的偏好设置（仪表板开关）；report_mode=False 则强制仅生成图表。

长时间运行的生成任务

详细图表可能需要一两分钟才能生成，而某些 MCP 客户端会在大约 60 秒后取消任何工具调用。因此，UML Forge 工具最多等待 45 秒以获取结果。如果图表仍在生成，工具会返回任务 ID；图表准备就绪后，可通过 umlforge_get_result 获取结果（结果保留一小时）。超时时间较长的客户端可在 MCP 配置的 env 块中设置 UMLFORGE_WAIT_SECONDS（5-200），以延长等待时间。