Architecture intelligence, security analysis, and living docs. 14 Mermaid tools.

How do I install UML Forge?

Clone UML Forge from https://github.com/dave1362/umlforge-connector and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is UML Forge open source?

Yes, UML Forge is open source under the MIT license. Source code is available at https://github.com/dave1362/umlforge-connector.

What category does UML Forge belong to?

UML Forge is listed under AI & ML MCP servers on MCPFind.

UML Forge — MCP Server for AI & ML

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 14 specialised tools 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

All tools accept report_mode=True to generate a written analysis report alongside the diagram.

Requirements

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

License

MIT ? see LICENSE.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-dave1362-umlforge": {
      "command": "uvx",
      "args": [
        "umlforge"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

UML Forge works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

UML Forge