@plantuml/mcp-js
OfficialThis server provides tools to validate, render, and explain PlantUML diagrams without requiring Java.
Get the embedded PlantUML library version via
plantuml_versionCheck a single diagram's syntax without rendering it (
check_syntax), returning validity, diagram type, line count, warnings, and error details (line number, message, line, context)Render a single diagram to deterministic SVG (
render_diagram), returning the SVG plus metadata or errorsExplain how a diagram is parsed line by line (
explain_diagram), returning input, explanation, and line numbers
đ§ŠNew! Render PlantUML diagrams directly inside GitHub with our official browser extension — No server. No tokens. No tracking. Zero permissions but clipboard.
đŹ Want native PlantUML support in GitHub? Upvote and join the discussion: Support for PlantUML diagrams
đ¤New! Give your AI assistant the power to render and check PlantUML diagrams with @plantuml/mcp-js — a pure Node.js MCP server. No Java. No server. Just npx @plantuml/mcp-js.
đą PlantUML
Generate UML diagrams from textual descriptions.
âšď¸ About
PlantUML is a component that allows you to create various UML diagrams through simple textual descriptions. From sequence diagrams to deployment diagrams and beyond, PlantUML provides an easy way to create visual representations of complex systems.
đď¸ Supported Diagram Types
đ§Š UML Diagrams
đ Non-UML Diagrams
Entity Relationship (ER) diagram
đŁ Additional Features
đ Learn More
For a more detailed overview, visit PlantUML Official Website.
Related MCP server: PlantUML MCP Server
đĄ Security
See Security Policy and Security overview.
đ Getting Started
Whether you're looking to use PlantUML as a standalone application or as a component in your own project, getting started is simple. Check out the official PlantUML setup guide for instructions on how to set up PlantUML on your system.
âď¸ Building from Source
To build PlantUML from source, you have two options:
Using Gradle:
./gradlew jarUsing Ant:
ant
For prerequisites and detailed build instructions, see our BUILDING.md guide.
đ Building for the Browser (TeaVM)
PlantUML can be compiled to JavaScript with TeaVM to run entirely client-side in the browser, with no server required. To produce the JavaScript artifacts and use them in your own project:
git clone https://github.com/plantuml/plantuml.git
cd plantuml
chmod +x ./gradlew
./gradlew clean teavm -Pfast
cp ./build/generated/teavm/js/plantuml.js $YOUR_PROJECT/plantuml.js
cp ./build/generated/teavm/js/viz-global.js $YOUR_PROJECT/viz-global.jsThe -Pfast flag skips the slow parts of a regular build (tests, Javadoc, JaCoCo) so you only get the TeaVM output. The viz-global.js file provides Viz.js (Graphviz) support for diagrams that rely on Dot layout.
The teavm task also copies the PlantUML stdlib bundles and a ready-to-use index.html demo into ./build/generated/teavm/js/.
For a live example of client-side rendering, see the JavaScript PlantUML Demo.
đ§ą Contributing
PlantUML is an open-source project, and we welcome contributions of all kinds. Whether you're helping us fix bugs, improve the docs, or spread the word, we appreciate your support. See our contributing guide for more information on how to get started.
The language guide on plantuml.com is updated through alphadoc. Edit a page there (pick a language and wiki syntax), save, and maintainers publish it after review. Details are in CONTRIBUTING.md.
For comprehensive and detailed documentation on using PlantUML, refer to the official Javadoc, available here. Please note that this documentation is a work in progress and may not be complete.
đ§âđ¤âđ§ Support and Community
đ License
PlantUML is licensed under several licenses; you can choose the one that suits you best:
For more information, please refer to the PlantUML license FAQ to help determine which license is appropriate for your use case.
Available Tools
4 toolscheck_syntaxA
Checks the syntax of a single PlantUML diagram without rendering it. Returns a JSON object containing: 'valid' (boolean), 'diagramType' (if valid), 'lineCount', 'warnings' (list of non-fatal warnings), and on failure 'errorLineNumber' (1-based line number), 'errorMessage', 'errorLine' (the offending source line, when available), and 'errorContext'.
Inputs: source (required).
explain_diagramA
Explains how a single PlantUML diagram is parsed, line by line. Returns a JSON array of objects, each containing: 'input' (the source line(s) that produced the explanation), 'explain' (a human-readable explanation), and 'line' (1-based line number, when available).
Inputs: source (required).
plantuml_versionA
Returns the version of the embedded PlantUML library (TeaVM JS build).
Inputs: no named parameters.
render_diagramA
Renders a single PlantUML diagram to a deterministic SVG. Returns a JSON object containing: 'valid' (boolean), and when valid 'diagramType', 'lineCount', 'warnings' (list of non-fatal warnings) and 'svg' (the rendered SVG as a string). On failure it has the same error shape as check_syntax: 'errorLineNumber' (1-based), 'errorMessage', 'errorLine' (the offending source line, when available) and 'errorContext'.
Inputs: source (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogâŚ
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: syntax validation, SVG rendering, parse explanation, and library version lookup. An agent can select among them without meaningful overlap, even though check_syntax and render_diagram share an error shape.
All names use snake_case consistently. Three follow a verb_noun pattern (check_syntax, render_diagram, explain_diagram), while plantuml_version is a noun-only name, a minor deviation but still readable and predictable.
Four tools is well-scoped for a focused PlantUML diagram utility server, and each one earns its place without redundancy. There is no sense of a thin or padded surface.
The surface covers the core lifecycle for a single diagram: validate, render, explain, and report the engine version. Minor gaps exist, such as batch/multi-diagram handling or output format options (e.g. PNG), but agents can work around these for the stated single-diagram purpose.
Maintenance
Related MCP Connectors
Render, validate, encode/decode PlantUML diagram-as-code; 22 diagram types. Free, no auth.
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
Thermal label MCP server: render, validate, debug and convert ZPL, EPL, TSPL and CPCL labels.
Web scraping MCP server: any URL to Markdown or JSON, with JavaScript rendering and batch jobs.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables generation of PlantUML diagrams (sequence, class, C4, architecture) with embeddable SVG/PNG URLs, encoding/decoding capabilities, and automatic syntax error detection and fixing.31,041 npm55MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to generate UML diagrams from text descriptions using PlantUML, supporting multiple output formats (PNG, SVG, PDF), syntax validation, and diagram source extraction.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that validates Mermaid diagram syntax and identifies diagram types across all major formats. It provides detailed parse-error messages for invalid diagrams without requiring external rendering processes.9 npm3MIT
- AlicenseAqualityBmaintenanceMCP server for rendering 35+ diagram types â sequence, flowchart, ER, C4, gantt, mindmap, infra, and more â to SVG/PNG with browser preview. Local rendering with palette/theme support and shareable diagrammo.app URLs.14454 npm3MIT