UML Forge

io.github.dave1362由 GitHub 账号 dave1362 发布v0.4.0更新于 Oct 28, 2026

Architecture intelligence, security analysis, and living docs. 15 tools, Mermaid output.

已验证STDIO仅桌面开发者工具安全与监控媒体与设计

概览

AI 生成的概览

UML Forge 为编码助手提供 15 个工具，可从代码、数据库结构或描述生成 UML 与架构图、威胁模型和活文档。

可以做什么
  • 用自然语言描述目标，推荐合适的绘图工具并给出可直接运行的调用
  • 从代码库或 GitHub 地址反向生成类图、时序图和状态图
  • 根据领域描述或 SQL 结构生成 ER 图，根据业务规则生成状态机
  • 绘制前端组件、部署与 CI/CD、事件驱动以及 AI 智能体拓扑图
  • 生成 STRIDE 威胁模型、面向干系人的 C4 上下文图、新人上手包和遗留系统迁移路线图
  • 按迭代或 PR 变更更新已有图表，可选附带书面分析报告，并取回耗时任务的生成结果
适用场景
适合希望根据现有代码库、数据库结构或文字描述自动产出架构与设计图，而不想手绘的场景；也适合需要安全威胁模型、面向非技术干系人的上下文图，或遗留系统迁移方案的场合。
运行要求
以本地 Python 包形式运行（需 Python 3.11+），通过 uvx 启动。需要 UML Forge API 密钥，通过环境变量 UMLFORGE_API_KEY 提供，有免费额度。需能访问 UML Forge 服务。可选设置 UMLFORGE_WAIT_SECONDS 调整等待时间。
安装前请注意
API 密钥属于机密，经环境变量传入，请勿写入共享配置。图表内容、代码或结构描述会上传到 UML Forge 服务生成，请勿提交无法外传的敏感代码或架构细节。耗时任务的结果仅保留一小时。

安装

在 SourceWeft 中

  1. 打开 控制台中的 UML Forge，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

UML Forge MCP Connector

Architecture intelligence, security analysis, and living documentation — inside your coding agent.

UML Forge gives Claude Code, Cursor, Windsurf, and any MCP-compatible coding agent a suite of 15 tools (14 diagram tools plus umlforge_get_result) for producing professional UML diagrams from your codebase, schema, or architecture descriptions.

Quick start

Claude Code:

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

Cursor / Windsurf — add the same block to your MCP settings.

Get your API key at umlforge.dev.

Tools included

ToolDescription
umlforge_suggestStart here. Describe your goal in plain English — returns the right tool and a ready-to-run call
umlforge_reverse_engineerClass, sequence, and state diagrams from a codebase or GitHub URL
umlforge_api_sequenceSequence diagrams for request flows across services
umlforge_erd_schemaEntity-relationship diagrams from domain descriptions or SQL schemas
umlforge_state_machineState diagrams from entity lifecycles and business rules
umlforge_frontend_componentsComponent hierarchy and interaction diagrams for UI features
umlforge_deploymentInfrastructure and CI/CD pipeline diagrams
umlforge_threat_modelSTRIDE threat model + attack surface diagram
umlforge_event_drivenEvent flow and pub/sub architecture diagrams
umlforge_ai_agentAgent topology and tool-call flow diagrams for LLM pipelines
umlforge_stakeholder_archC4 context diagrams for investors, CTOs, and non-technical stakeholders
umlforge_living_docsUpdate existing diagrams to reflect sprint or PR changes
umlforge_onboardingDay-one knowledge-transfer package for new team members
umlforge_legacy_migrationLegacy structure + modern architecture diagrams and 6-phase migration roadmap from COBOL, Fortran, ABAP, RPG, and other legacy languages
umlforge_get_resultRetrieve a generation that was still running (see Long-running generations)

All diagram tools accept report_mode=True to generate a written analysis report alongside the diagram. Leave report_mode unset to follow your account's saved preference (the dashboard toggle); report_mode=False forces diagrams only.

Long-running generations

A detailed diagram can take a minute or two, and some MCP clients cancel any tool call after about 60 seconds. UML Forge tools therefore wait up to 45 seconds for the result. If a diagram is still generating, the tool replies with a job id and umlforge_get_result retrieves it when it is ready (results are kept for one hour). Clients with longer timeouts can wait longer by setting UMLFORGE_WAIT_SECONDS (5-200) in the env block of your MCP configuration.

Requirements

  • Python 3.11+
  • An API key from umlforge.dev (free tier available)

License

MIT — see LICENSE.

来源：README.md，提交 fbb4675

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

3
  1. v0.4.0最新Oct 17, 2026
  2. v0.3.0Oct 16, 2026
  3. v0.2.2Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分