# PlantUML Diagrams

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1819 installs · ★ 55 repo stars
- Author: infobip
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/infobip/plantuml-mcp-server
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/plantuml-diagrams

## What it 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.

## Requirements
- Remote server: `https://plantuml-mcp-server--infobip.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http plantuml-mcp-server https://plantuml-mcp-server--infobip.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add plantuml-diagrams --url https://plantuml-mcp-server--infobip.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "plantuml-diagrams": {
            "url": "https://plantuml-mcp-server--infobip.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "plantuml-diagrams": {
            "type": "http",
            "url": "https://plantuml-mcp-server--infobip.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http plantuml-diagrams https://plantuml-mcp-server--infobip.run.tools
```

## When to use it
- 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
- 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

## Similar
- [plantuml](https://affpapa.org/en/nevibecode/skills/plantuml.md) — skill · 3 installs
- [architecture-diagrams](https://affpapa.org/en/nevibecode/skills/architecture-diagrams.md) — skill · 2000 installs
- [plantuml-skill](https://affpapa.org/en/nevibecode/skills/plantuml-skill.md) — skill · 4200 installs
- [033-architecture-diagrams](https://affpapa.org/en/nevibecode/skills/033-architecture-diagrams.md) — skill · 366 installs
- [plantuml-ascii](https://affpapa.org/en/nevibecode/skills/plantuml-ascii.md) — skill · 9740 installs
- [plantuml-diagram-generator](https://affpapa.org/en/nevibecode/skills/plantuml-diagram-generator.md) — skill · 123 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
