UML Forge

Name: UML Forge
Author: dave1362

Local

github.com/dave1362Developer Tools0Updated 2w ago

Repository

About UML Forge

UML Forge is an MCP server for coding agents that turns codebases, schemas, and architecture descriptions into UML diagrams. Its tools also cover security analysis, onboarding, and updates to existing diagrams.

Key features

01Reverse-engineer code into diagrams
02Create API and event-flow sequences
03Generate ERD and state diagrams
04Model threats and attack surfaces
05Update diagrams for sprint or PR changes

Use cases

01Map services and request flows
02Analyze an architecture’s attack surface
03Document a legacy migration
04Prepare onboarding material for a team

MCP support

It exposes 15 tools to MCP-compatible coding agents for diagram generation and analysis. Long-running jobs can be retrieved with `umlforge_get_result`.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commanduvx umlforge

Environment variables to set

UMLFORGE_API_KEYSecretYour UML Forge API key — get one free at https://umlforge.dev

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

pypiumlforge0.4.0stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required
codebase	string	No
max_nodes	integer	No
github_url	any	No
report_mode	boolean	No
github_token	any	No

Details

From the project 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:

{
  "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

Tool	Description
`umlforge_suggest`	Start here. Describe your goal in plain English — returns the right tool and a ready-to-run call
`umlforge_reverse_engineer`	Class, sequence, and state diagrams from a codebase or GitHub URL
`umlforge_api_sequence`	Sequence diagrams for request flows across services
`umlforge_erd_schema`	Entity-relationship diagrams from domain descriptions or SQL schemas
`umlforge_state_machine`	State diagrams from entity lifecycles and business rules
`umlforge_frontend_components`	Component hierarchy and interaction diagrams for UI features
`umlforge_deployment`	Infrastructure and CI/CD pipeline diagrams
`umlforge_threat_model`	STRIDE threat model + attack surface diagram
`umlforge_event_driven`	Event flow and pub/sub architecture diagrams
`umlforge_ai_agent`	Agent topology and tool-call flow diagrams for LLM pipelines
`umlforge_stakeholder_arch`	C4 context diagrams for investors, CTOs, and non-technical stakeholders
`umlforge_living_docs`	Update existing diagrams to reflect sprint or PR changes
`umlforge_onboarding`	Day-one knowledge-transfer package for new team members
`umlforge_legacy_migration`	Legacy structure + modern architecture diagrams and 6-phase migration roadmap from COBOL, Fortran, ABAP, RPG, and other legacy languages
`umlforge_get_result`	Retrieve 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.