Skip to content
← All projects
Project

uml-mcp

Listen to the audio story

Diagrams on demand, right from chat · 1:22 · AI-written script, synthetic voices

Transcript

Ava: You're in your editor, thinking about how a system fits together. What if you just asked for the diagram, and it appeared?

Andrew: That would beat dragging boxes around.

Ava: That's uml-mcp, an open-source server Antoine built for the Model Context Protocol, or M C P. It turns a plain-language request, or diagram code you already wrote, into Mermaid, PlantUML or Kroki diagrams.

Andrew: What does M C P do here?

Ava: Think of it as a universal plug. It lets an AI assistant call tools, so the assistant can say, make me a sequence diagram, and uml-mcp does the drawing.

Andrew: Where can you use it?

Ava: In Cursor, as M C P tools, or in ChatGPT through a custom GPT. There's also a hosted version you can try.

Andrew: What kinds of diagrams?

Ava: The generate U M L tool and related ones cover sequence, class, flow and deployment sketches. Three render backends mean you can pick the engine that suits you.

Andrew: Anything cool about how it's used?

Ava: Antoine uses it across his own blog, for the inline diagrams in his posts.

Andrew: And getting started?

Ava: Clone the repository and follow the README for the Python setup and the Cursor config. It grew out of his earlier ChatGPT plugin for diagrams.

Andrew: The project page has the links and the blog write-up.

Table of contents

GitHub stars GitHub last commit

Repository · MIT License · Docs · Hosted MCP

uml-mcp is an open-source Model Context Protocol server that generates Mermaid, PlantUML, and Kroki diagrams from natural-language prompts or explicit diagram source. Use it in Cursor (MCP tools) or ChatGPT via a Custom GPT.

Blog write-up: uml-mcp — diagrams from chat.

Features

  • generate_uml and related MCP tools for sequence, class, flow, and deployment sketches
  • Multiple render backends (Mermaid, PlantUML, Kroki)
  • Used across this portfolio blog for inline .mmd + SVG diagrams

Quick start

git clone https://github.com/antoinebou12/uml-mcp.git
cd uml-mcp

Follow the README for Python dependencies and Cursor MCP configuration.