PlantUML Diagrams — Claude Code MCP server: install and use
PlantUML Diagrams — an MCP server that turns PlantUML code into embeddable SVG or PNG images and local files. It validates markup and automatically repairs broken diagram syntax.
MIT 1,819 installs ★ 55 updated 2026-10-27
claude mcp add --transport http plantuml-mcp-server https://plantuml-mcp-server--infobip.run.toolsWhat PlantUML Diagrams does
This server gives your coding assistant access to PlantUML generation via tools such as generate_plantuml_diagram, encode_plantuml, and decode_plantuml. The agent can build sequence flows, class structures, or C4 containers directly in conversation, returning ready-to-use image URLs.
It also bundles a prompt called plantuml_error_handling. If a diagram fails validation, this workflow instructs the model to inspect the compiler response and repair syntax flaws like misformed arrows or unclosed quotation marks.
Writing images to disk is locked down by default. The tool restricts output_path exclusively to .svg or .png files inside your current working directory. You must supply PLANTUML_ALLOWED_DIRS if you want to export diagrams to other folders.
What it helps with
- Render software architecture flows into SVG or PNG URLs
- Export generated diagrams directly to local image files
- Encode diagram source strings for sharing via web links
- Automatically correct broken PlantUML syntax without manual edits
Example prompts for the agent
- Generate a sequence diagram for our OAuth2 login flow and share the PNG link
- Export a C4 container diagram of this repository to
docs/system.svg - Encode this PlantUML snippet into a shareable string
How to install PlantUML Diagrams
Platform CLI: remote server
claude mcp add --transport http plantuml-mcp-server https://plantuml-mcp-server--infobip.run.toolsPlatform CLI: remote server
codex mcp add plantuml-diagrams --url https://plantuml-mcp-server--infobip.run.toolsConfig file
{
"mcpServers": {
"plantuml-diagrams": {
"url": "https://plantuml-mcp-server--infobip.run.tools"
}
}
}Config file
{
"servers": {
"plantuml-diagrams": {
"type": "http",
"url": "https://plantuml-mcp-server--infobip.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http plantuml-diagrams https://plantuml-mcp-server--infobip.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PlantUML Diagrams
How do I install PlantUML Diagrams in Claude Code?
Run claude mcp add --transport http plantuml-diagrams https://plantuml-mcp-server--infobip.run.tools in your terminal.
What does the plantuml_error_handling prompt do?
It teaches the agent how to parse validation responses from the renderer. When syntax issues arise, the model detects typos or missing syntax elements and re-runs the request with fixes.
Where can the server write diagram files locally?
By default, exports are limited to .svg and .png files within the active working directory. To write elsewhere, define target paths in the PLANTUML_ALLOWED_DIRS environment variable.