Skip to content

About

UML-MCP connects AI assistants to textual diagram languages over the Model Context Protocol. The repo is one Python codebase: MCP server, light validation, batching, and a Kroki / PlantUML / Mermaid fallback chain, runnable locally, in Docker, or on Vercel.

Citation

If UML-MCP helps your research, tooling, or product, please cite it:

@software{uml_mcp,
  author = {Antoine Boucher and contributors},
  title  = {{UML-MCP: Diagram Generation via the Model Context Protocol}},
  url    = {https://github.com/antoinebou12/uml-mcp},
  year   = {2025}
}

A GitHub star also helps others discover the project.

Star History Chart

License

UML-MCP is released under the MIT License.

You are free to use, modify, and distribute this code in your projects, including commercial ones, as long as you keep the original copyright and license notice. If you embed UML-MCP in a product you ship, include a copy of the original copyright and license notice, for example in your product documentation, an "About" or "Third-Party Licenses" section, or another clear third-party notice.

Acknowledgements

UML-MCP would not exist without the work of the upstream rendering projects:

  • PlantUML: text-to-UML engine.
  • Kroki: unified API for 30+ diagram languages.
  • Mermaid: JavaScript-native flowcharts, sequence, class, state, Gantt, and ER diagrams.
  • D2: declarative diagram language.
  • TikZ/PGF: TeX-quality vector graphics.

And the MCP ecosystem:

Maintainers

Get in touch