generate_uml
Generate any UML or diagram by type (class, sequence, mermaid, d2, etc.)
LABSCO SUMMARY
A broken diagram fails before it costs a round trip.
validate_uml checks the type, format, code length and basic syntax locally and returns suggestions, so the ordinary mistakes surface without a Kroki call. generate_uml_batch takes a list with one shared output directory and reports results per index, which is the shape you want when a rename means regenerating every diagram in a document.
What it is
A Kroki-backed diagram renderer with four tools: list the supported types, validate source locally, render one diagram, or render a batch in a single call.
What you get
- A diagram rendered from source by type — class, sequence, mermaid and d2 among them — with output format, theme, scale and output directory
- A batch of diagrams rendered in one call, sharing an output_dir, returning per-index results or errors
- Local validation of diagram type, format, code length and basic syntax, returning errors and suggestions without calling Kroki
- The supported types listed with their Kroki backend, description and formats, for clients that cannot read the uml://types resource
Requirements
uv on your PATH, which resolves the Python runtime through UV_PYTHON. Rendering goes out to Kroki; validation runs locally.
Setup effort
Build from source — git clone https://github.com/antoinebou12/uml-mcp.git && cd uml-mcp
USE CASES
01
Getting a diagram out of a description you already wrote
Check which types the server supports and what formats each can render to, then generate the diagram with a theme, scale and output directory.
02
Regenerating every diagram in a document after a rename
Validate the edited sources locally first, then render them as one batch into a shared output directory and read the per-index results to see which ones failed.
03
Fixing diagram source that will not render
Run the local check to get the errors and suggestions without a round trip, correct the source, and render once it passes.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
generate_uml_batch
Generate multiple diagrams in one call. Each item is like generate_uml (diagram_type, code, output_format?, theme?, scale?). Optional shared output_dir for all items. Returns a list of per-index results or errors.
list_diagram_types
List supported diagram types with Kroki backend, description, and formats (same data as uml://types resource). Use when the client cannot read resources.
validate_uml
Validate diagram type, format, code length, and basic syntax locally before render (no Kroki call). Returns errors and suggestions.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected.
Requires
- For the hosted endpoint: a client that can reach a remote MCP server over HTTP
- For a local run: uv (uv sync installs the Python dependencies into .venv)
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
Setup
TERMINAL
git clone https://github.com/antoinebou12/uml-mcp.git && cd uml-mcp
uv sync
uv run python server.pyHosted endpoint
ENDPOINT URL
https://uml-mcp.vercel.app/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"uml-mcp": {
"url": "https://uml-mcp.vercel.app/mcp"
}
}
}Claude Desktop
After uv sync in your clone, point Claude Desktop at the Python inside the clone's .venv, with absolute paths.
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"uml-mcp": {
"command": "<YOUR_PATH_TO_UML_MCP>/.venv/bin/python",
"args": [
"-u",
"<YOUR_PATH_TO_UML_MCP>/server.py"
],
"env": {
"MCP_OUTPUT_DIR": "<YOUR_PATH_TO_UML_MCP>/output"
}
}
}
}Claude Code
CLAUDE CODE · IN CLIENT
/plugin marketplace add https://github.com/antoinebou12/uml-mcp
/plugin install uml-mcp@uml-mcp-pluginsSmithery
SMITHERY · TERMINAL
npm install -g @smithery/cli@latest
smithery auth login
smithery mcp add antoinebou12/uml --client cursorOther routes
Docker — self-host
DOCKER — SELF-HOST · TERMINAL
docker build -t uml-mcp .
docker run -p 8000:8000 uml-mcp
