UML Forge

io.github.dave1362Published by GitHub account dave1362v0.4.0Updated Oct 28, 2026

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

VerifiedSTDIODesktop onlyDeveloper ToolsSecurity & MonitoringMedia & Design

Overview

AI-generated overview

UML Forge gives a coding agent 15 tools to generate UML and architecture diagrams, threat models and living docs from code, schemas or descriptions.

What you can do
  • Suggest the right diagram tool from a plain-English goal and return a ready-to-run call
  • Generate class, sequence and state diagrams by reverse-engineering a codebase or GitHub URL
  • Produce ERDs from domain descriptions or SQL schemas, plus state machines from business rules
  • Draw frontend component, deployment and CI/CD, event-driven and AI agent topology diagrams
  • Create STRIDE threat models, C4 stakeholder context diagrams, onboarding packages and legacy migration roadmaps
  • Update existing diagrams for sprint or PR changes, optionally with a written analysis report, and fetch results of long-running jobs
When to use it
Useful when you want architecture and design diagrams produced from an existing repository, database schema or written description without drawing them by hand, or when you need security threat models, stakeholder-facing context diagrams or migration plans for legacy systems.
Requirements
Runs locally as a Python package (Python 3.11+) launched via uvx. Requires a UML Forge API key supplied in the UMLFORGE_API_KEY environment variable; a free tier is available. Network access to the UML Forge service is implied. UMLFORGE_WAIT_SECONDS can optionally adjust the wait time.
Before you install
The API key is a secret passed in the environment and should be kept out of shared configs. Diagram content, code or schema descriptions are sent to the UML Forge service for generation, so avoid submitting sensitive code or architecture details you cannot share. Results of long-running jobs are kept for one hour only.

Installation

In SourceWeft

  1. Open UML Forge in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: README.md at commit fbb4675

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

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

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts