uml-mcp
UML-MCP Server is a UML diagram generation tool based on MCP (Model Context Protocol), which can help users generate various types of UML diagrams through natural language description or directly writing PlantUML and Mermaid and Kroki https://uml-mcp.vercel.app/mcp
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/antoinebou12/uml-mcp with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/antoinebou12/uml-mcp'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/antoinebou12--uml-mcp)HTML
<a href="/listings/antoinebou12--uml-mcp"><img src="/api/listings/antoinebou12--uml-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Remote (recommended)** — add to your MCP client:
"uml-mcp": {
"transport": "http",
"url": "https://uml-mcp.vercel.app/mcp"
}Use **`/mcp`**, not the site root. Then ask: *“Draw a sequence diagram of a user logging in through an API gateway.”* or paste PlantUML / Mermaid / Kroki source.
Repo defaults: [`.cursor/mcp.json`](.cursor/mcp.json) · [`.vscode/mcp.json`](.vscode/mcp.json) · [`.codex/config.toml`](.codex/config.toml).
| Client | Config | Guide | | --- | --- | --- | | Cursor | [`.cursor/mcp.json`](.cursor/mcp.json) | [docs/integrations/cursor.md](docs/integrations/cursor.md) | | VS Code / Copilot | [`.vscode/mcp.json`](.vscode/mcp.json) | [docs/integrations/vscode_copilot.md](docs/integrations/vscode_copilot.md) | | OpenAI Codex | [`.codex/config.toml`](.codex/config.toml) | [docs/integrations/openai_codex.md](docs/integrations/openai_codex.md) | | Ollama / Open WebUI | [`config/openwebui_mcp.json`](config/openwebui_mcp.json) | [docs/integrations/ollama.md](docs/integrations/ollama.md) | | Claude Desktop | [`config/claude_desktop_*.json`](config/) | [docs/integrations/claude_desktop.md](docs/integrations/claude_desktop.md) |
All snippets: [`config/README.md`](config/README.md)
**Install locally (guided):**
| Path | Command | | --- | --- | | Installer (needs only Python + typer + tqdm) | `python scripts/install.py` | | Setup wizard | `uv tool install uml-mcp && uml-mcp setup` (profile, features, clients, health check) | | Web setup form | `uml-mcp setup --web` → setup page in the console | | Manual | `uml-mcp config init --profile local` · `uml-mcp client install --client vscode\|cursor\|claude-desktop\|claude-code` |
Guide: [docs/installation.md](docs/installation.md)
<p align="center"> </p>
<p align="center"><sub>Admin console (<code>uml-mcp admin</code>): overview · setup · settings · activity · logs · metrics · plugins, light and dark, desktop and mobile</sub></p>
<details> <summary><strong>Clone from origin (local stdio)</strong></summary>
git clone https://github.com/antoinebou12/uml-mcp.git cd uml-mcp uv sync uv run python server.py
If you already have the repo and need to set origin:
git remote add origin https://github.com/antoinebou12/uml-mcp.git
Configs: [`config/README.md`](config/README.md) (Cursor, VS Code, Codex, Claude, Open WebUI, Continue)
</details>
<details> <summary><strong>Claude Code plugin</strong></summary>
/plugin marketplace add https://github.com/antoinebou12/uml-mcp /plugin install uml-mcp@uml-mcp-plugins
[docs/integrations/claude_code.md](docs/integrations/claude_code.md) · Cursor skill: [`.skill/skills/uml-mcp-diagrams/SKILL.md`](.skill/skills/uml-mcp-diagrams/SKILL.md)
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 23 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "uml-mcp-plugins",
- "metadata": {
- "description": "Official Claude Code plugins for the UML-MCP diagram MCP server (PlantUML, Mermaid, D2, Kroki).",
- "version": "1.4.0"
- },
- "owner": {
- "name": "Antoine Boucher",
- "url": "https://github.com/antoinebou12"
- },
- "plugins": [
- {
- "name": "uml-mcp",
- "source": "./plugins/uml-mcp",
- "description": "Hosted HTTP MCP at uml-mcp.vercel.app plus /uml-mcp:uml-diagrams skill for URL-first diagram workflows.",
- "version": "1.4.0",
- "homepage": "https://github.com/antoinebou12/uml-mcp",
- "repository": "https://github.com/antoinebou12/uml-mcp",
- "license": "MIT",
- "keywords": ["mcp", "diagrams", "uml", "mermaid", "plantuml", "kroki", "d2"]
- }
- ]
- }
README.md · README · 210 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <img src="docs/assets/favicon.svg" width="84" alt="UML-MCP logo" />
- # UML-MCP
- **Diagrams for AI assistants.** A [Model Context Protocol](https://modelcontextprotocol.io/) server
- that turns a description or diagram source into a rendered diagram, inside the chat.
- [](https://github.com/antoinebou12/uml-mcp/actions/workflows/test.yml)
- [](https://antoinebou12.github.io/uml-mcp/)
- [](https://github.com/antoinebou12/uml-mcp/releases)
- [](LICENSE)
- [](https://www.python.org/downloads/)
- [](https://github.com/antoinebou12/uml-mcp/stargazers)
- [](https://github.com/antoinebou12/uml-mcp/graphs/contributors)
- [](https://github.com/antoinebou12/uml-mcp/commits/main)
- [**Docs**](https://antoinebou12.github.io/uml-mcp/) ·
- [**Quick start**](#quick-start) ·
- [**Kroki diagrams**](#kroki-diagrams) ·
- [**Interactive diagrams**](#interactive-diagrams) ·
- [**Changelog**](CHANGELOG.md) ·
- [**Contributing**](CONTRIBUTING.md)
- </div>
- ## It works as an MCP App
- In clients that support MCP Apps, diagrams open in a viewer inside the chat
- (`ui://uml-mcp/diagram-viewer`): zoom, edit the source, switch theme and format, re-render, step
- through a batch, and export SVG, PNG, HTML or PDF. Clients without MCP Apps get the same diagram
- as an inline PNG and SVG.
- <p align="center">
- <a href="docs/assets/mcp-app-demo.mp4"><img src="docs/assets/mcp-app-demo.gif" width="420" alt="Recording of the UML-MCP viewer inside a chat: four diagram tabs from one batch call, switching tabs, then re-rendering with another format." /></a>
- </p>
- <p align="center"><sub>One <code>generate_uml_batch</code> call returns four diagrams as tabs, then one is re-rendered in another format. <a href="docs/assets/mcp-app-demo.mp4">Full-quality video</a> · <a href="docs/integrations/mcp-app.md">more about the viewer</a>.</sub></p>
- <p align="center">
- <img src="docs/assets/diagrams/client-server-chat.png" width="680" alt="UML-MCP in chat: a Client/Server Mermaid sequence diagram with URL and Playground links" />
- </p>
- <p align="center"><sub>In any other chat client: the inline image with links to the rendered file and an editable playground.</sub></p>
- ## Why UML-MCP
- - **52 diagram types.** 37 through [Kroki](https://kroki.io/) (UML, Mermaid, D2, Graphviz, C4, BPMN,
- ERD, TikZ...) and 15 interactive ones, including cloud and stack diagrams with real logos,
- architecture, workflow and sequence diagrams, 2D/3D LLM visualisations, database schemas,
- dependency graphs, statecharts, agent traces, C4 models and timelines.
- - **Shows up in the chat.** Every client gets an inline image plus links to the rendered file and
- an editable playground. Clients with [MCP Apps](https://modelcontextprotocol.io/) also get an
- interactive viewer.
- - **Ready to run.** Hosted endpoints, or local with Docker or Helm; optional Entra ID / OAuth 2.1
- SSO, audit logs and metrics. It scores 95/100 on the Manufact publishing checklist.
- ## Quick start
- Add the hosted server to your MCP client:
- ```json
- "uml-mcp": {
- "transport": "http",
- "url": "https://uml-mcp.vercel.app/mcp"
- }
- ```
- Then ask, for example, *"Draw a sequence diagram of a user logging in through an API gateway."*
- | Endpoint | URL |
- | --- | --- |
- | Primary (Vercel) | `https://uml-mcp.vercel.app/mcp` |
- | Mirror (Manufact) | `https://uml-mcp.antoineboucher.info/mcp` |
- Ready-made configs: [Cursor](.cursor/mcp.json) · [VS Code / Copilot](.vscode/mcp.json) ·
- [Codex](.codex/config.toml) · [Claude Desktop](config/) · [Open WebUI](config/openwebui_mcp.json) ·
- [all clients](config/README.md). To run it yourself:
- ```bash
- uv tool install uml-mcp && uml-mcp setup
- ```
- The [installation guide](docs/installation.md) covers Docker, Helm and running from source.
- To explore all 15 interactive types from a checkout, use the
- [local viewer preview](docs/integrations/mcp-app.md#local-viewer-preview). Its compact
- example picker changes diagrams automatically and keeps export controls in the viewer.
- ## Kroki diagrams
- 37 types through [Kroki](https://kroki.io/): UML (PlantUML), Mermaid, D2, Graphviz, C4, BPMN,
- ERD, TikZ and more. Call `generate_uml` / `generate_uml_image` with the `diagram_type` under
- each thumbnail. Source examples live in [`examples/`](examples/) and at `uml://examples`;
- notation guides are in [Diagram types](docs/diagrams/index.md). Regenerate this gallery with
- `uv run python scripts/build_kroki_gallery.py`.
- | | | |
- | --- | --- | --- |
- | [](docs/diagrams/uml.md)<br>`class` | [](docs/diagrams/uml.md)<br>`sequence` | [](docs/diagrams/uml.md)<br>`activity` |
- | [](docs/diagrams/uml.md)<br>`usecase` | [](docs/diagrams/uml.md)<br>`state` | [](docs/diagrams/uml.md)<br>`component` |
- | [](docs/diagrams/uml.md)<br>`deployment` | [](docs/diagrams/uml.md)<br>`object` | [](docs/diagrams/uml.md)<br>`plantuml` |
- | [](docs/diagrams/mermaid.md)<br>`mermaid` | [](docs/diagrams/d2.md)<br>`d2` | [](docs/diagrams/graphviz.md)<br>`graphviz` |
- | [](docs/diagrams/erd.md)<br>`erd` | [](docs/diagrams/c4plantuml.md)<br>`c4plantuml` | [](docs/diagrams/bpmn.md)<br>`bpmn` |
- | [](docs/diagrams/blockdiag.md)<br>`blockdiag` | [](docs/diagrams/blockdiag.md)<br>`seqdiag` | [](docs/diagrams/blockdiag.md)<br>`actdiag` |
- | [](docs/diagrams/blockdiag.md)<br>`nwdiag` | [](docs/diagrams/blockdiag.md)<br>`packetdiag` | [](docs/diagrams/blockdiag.md)<br>`rackdiag` |
- | [](docs/diagrams/dbml.md)<br>`dbml` | [](docs/diagrams/structurizr.md)<br>`structurizr` | [](docs/diagrams/tikz.md)<br>`tikz` |
- | [](docs/diagrams/specialty.md)<br>`ditaa` | [](docs/diagrams/specialty.md)<br>`nomnoml` | [](docs/diagrams/specialty.md)<br>`svgbob` |
- | [](docs/diagrams/specialty.md)<br>`goat` | [](docs/diagrams/specialty.md)<br>`pikchr` | [](docs/diagrams/specialty.md)<br>`excalidraw` |
- | [](docs/diagrams/specialty.md)<br>`bytefield` | [](docs/diagrams/specialty.md)<br>`wavedrom` | [](docs/diagrams/specialty.md)<br>`wireviz` |
- | [](docs/diagrams/specialty.md)<br>`symbolator` | [](docs/diagrams/specialty.md)<br>`umlet` | [](docs/diagrams/specialty.md)<br>`vega` |
- | [](docs/diagrams/specialty.md)<br>`vegalite` | [](docs/diagrams/specialty.md)<br>`wireviz` | |
- ## Interactive diagrams
- The plugins below ship with UML-MCP and are on by default. Each type renders to an interactive HTML
- page in the viewer and to a static SVG and PNG everywhere else.
- | Plugin | Types | What you get |
- | --- | --- | --- |
- | [D3](docs/plugins/d3.md) | `d3_force` · `d3_architecture` · `d3_topology` | Force graphs and cloud diagrams with real provider and brand logos, routed with A\* |
- | [Stack diagram](docs/plugins/stack-diagram.md) | `stack_diagram` | Icon tiles, nested vendor and region groups, numbered request steps |
- | [Archify](docs/plugins/archify.md) | `archify_architecture` · `archify_workflow` · `archify_sequence` | Colour-coded groups, legend, three presets, click to focus and trace the shortest path |
- | [LLM visualizer](docs/plugins/llm-visualizer.md) | `llm_2d` · `llm_3d` | Layer maps, autoencoder and GAN shapes, `N×` blocks and a rotatable 3D scene |
- | [Database schema](docs/plugins/schema.md) | `db_schema` | ER diagrams from SQL DDL or JSON: column cards, crow's-foot keys at the column rows, search |
- | [Dependency graphs](docs/plugins/deps.md) | `dependency_graph` | A project's dependency tree from `package.json`, `pyproject.toml`, `requirements.txt` or a lock file |
- | [Statechart](docs/plugins/statechart.md) | `state_machine` | XState-like machines as statecharts, and a simulator that fires events, with a step log and Undo |
- | [Agent traces](docs/plugins/trace.md) | `agent_trace` | An agent run as a waterfall and a flow: LLM, tool and retrieval steps with tokens, cost, retries and the critical path |
- | [C4 model](docs/plugins/c4.md) | `c4_model` | One model, three C4 levels: click a system to open its containers, a container for its components |
- | [Timeline](docs/plugins/timeline.md) | `timeline` | Roadmaps with swimlanes, phases, milestones, releases and dependency arrows; zoom from quarters to days |
- Each image links to the plugin guide. The [complete smoke-test prompt](tests/prompts/all_interactive_plugins_smoke_test.md)
- covers every type, both themes, browser interactions and file exports.
- | | | |
- | --- | --- | --- |
- | [](docs/plugins/d3.md)<br>`d3_force` | [](docs/plugins/d3.md)<br>`d3_architecture` | [](docs/plugins/d3.md)<br>`d3_topology` |
- | [](docs/plugins/stack-diagram.md)<br>`stack_diagram` | [](docs/plugins/archify.md)<br>`archify_architecture` | [](docs/plugins/archify.md)<br>`archify_workflow` |
- | [](docs/plugins/archify.md)<br>`archify_sequence` | [](docs/plugins/llm-visualizer.md)<br>`llm_2d` | [](docs/plugins/llm-visualizer.md)<br>`llm_3d` |
- | [](docs/plugins/schema.md)<br>`db_schema` | [](docs/plugins/deps.md)<br>`dependency_graph` | [](docs/plugins/statechart.md)<br>`state_machine` |
- | [](docs/plugins/trace.md)<br>`agent_trace` | [](docs/plugins/c4.md)<br>`c4_model` | [](docs/plugins/timeline.md)<br>`timeline` |
- ```json
- {
- "title": "SaaS stack",
- "groups": [{"id": "vercel", "name": "Vercel", "icon": "vercel"}],
- "nodes": [
- {"id": "user", "name": "User", "icon": "user"},
- {"id": "web", "name": "Next.js", "icon": "browser", "group": "vercel"},
- {"id": "db", "name": "Neon", "icon": "database"},
- {"id": "ci", "name": "GitHub Actions"}
- ],
- "edges": [
- {"from": "user", "to": "web", "label": "HTTPS", "step": 1},
- {"from": "web", "to": "db", "label": "SQL", "step": 2},
- {"from": "ci", "to": "web", "label": "deploy", "style": "dashed"}
- ]
- }
- ```
- Send that as `stack_diagram` and you get the GitHub and Vercel logos, two numbered steps and a
- dashed deploy edge. The [plugins guide](docs/plugins/index.md) has example prompts for every type
- and shows how to [write your own](docs/plugins/authoring.md).
- ## Tools
- | Tool | Purpose |
- | --- | --- |
- | `generate_uml` | Render one diagram: image, URL and playground link |
- | `generate_uml_image` | The same as an inline chat image (PNG by default) |
- | `validate_uml` | Check source before rendering; errors say how to fix it |
- | `list_diagram_types` | The live catalog, including plugin types |
- | `generate_uml_batch` | Many diagrams in one call |
- Resources (`uml://types`, `uml://examples`, `uml://templates`...), prompts and skills
- (`skill://uml-mcp-diagrams/SKILL.md` plus focused guides) are listed in the
- [reference](docs/reference/index.md).
- ## Documentation
- | Topic | Where |
- | --- | --- |
- | Getting started and tutorials | [Tutorials](docs/tutorials/index.md) |
- | Diagram types and notation | [Diagram types](docs/diagrams/index.md) |
- | Clients, Docker, Helm, Vercel | [Deploy](docs/deploy/index.md) |
- | MCP App viewer and publishing | [MCP App](docs/integrations/mcp-app.md) |
- | Configuration (`uml-mcp.yaml`) | [Configuration](docs/configuration/uml-mcp-yaml.md) |
- | Enterprise SSO, audit, metrics | [Enterprise](docs/enterprise/README.md) |
- | Plugins | [Plugins](docs/plugins/index.md) |
- | Admin console | [Admin](docs/admin/index.md) |
- ## Development
- ```bash
- uv sync --all-groups
- uv run pytest
- uv run ruff check . && uv run ty check
- uv run uml-mcp lint --strict --min-grade A
- ```
- About 1,800 tests, including browser tests of every interactive page inside the MCP App viewer.
- See [Testing](docs/testing.md) and [CONTRIBUTING.md](CONTRIBUTING.md).
- ## License
- [MIT](LICENSE). Maintained by [Antoine Boucher](https://github.com/antoinebou12). Built on
- [PlantUML](https://plantuml.com/), [Kroki](https://kroki.io/), [Mermaid](https://mermaid.js.org/),
- [D2](https://d2lang.com/) and [D3](https://d3js.org/). Brand logos come from
- [LobeHub Icons](https://github.com/lobehub/lobe-icons) (MIT) and remain trademarks of their owners.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.