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 分