PlantUML-MCP-Server

@mzagar

About PlantUML-MCP-Server

A Model Context Protocol (MCP) server that provides PlantUML diagram generation capabilities for Claude Desktop and Claude Code.

#plantuml #puml #uml #diagram #diagrams

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "plantuml": {
      "command": "npx",
      "args": [
        "plantuml-mcp-server"
      ],
      "env": {
        "PLANTUML_SERVER_URL": "https://www.plantuml.com/plantuml"
      }
    }
  }
}

Tools

Generate a PlantUML diagram and return embeddable image URL

Encode PlantUML code for URL usage

Decode encoded PlantUML string back to PlantUML code

Overview

What is PlantUML-MCP-Server?

A Model Context Protocol (MCP) server that integrates PlantUML diagram generation into Claude Desktop and Claude Code. It provides tools to generate, encode, and decode PlantUML diagrams, producing embeddable SVG/PNG URLs.

How to use PlantUML-MCP-Server?

Add the server to Claude Desktop or Claude Code using npx plantuml-mcp-server and optionally set the PLANTUML_SERVER_URL environment variable (defaults to public PlantUML server). After activation, ask Claude to generate any PlantUML diagram type (sequence, class, C4, etc.) using the generate_plantuml_diagram tool.

Key features of PlantUML-MCP-Server

Three tools: generate, encode, and decode PlantUML diagrams.
Produces embeddable SVG/PNG URLs for diagrams.
Supports advanced PlantUML features like !include and external libraries.
Configurable PlantUML server URL via environment variable.
Works with both Claude Desktop and Claude Code.

Use cases of PlantUML-MCP-Server

Quickly create sequence diagrams to document workflows within Claude.
Generate C4 architecture diagrams for software projects.
Encode or decode PlantUML code for sharing via URLs.
Embed diagrams in Claude responses without leaving the chat.

FAQ from PlantUML-MCP-Server

What tools does PlantUML-MCP-Server provide?

It provides three tools: generate_plantuml_diagram to create diagrams with SVG/PNG URLs, encode_plantuml to convert PlantUML code into an encoded string, and decode_plantuml to reverse the encoding.

How do I configure a custom PlantUML server?

Set the PLANTUML_SERVER_URL environment variable to your server’s URL when adding the MCP server to Claude Desktop or Claude Code (default is https://www.plantuml.com/plantuml).

What are the runtime requirements?

Node.js 18+ and npm are required for local installation. The server runs via npx without local installation for normal use.

Does this server store any data or require authentication?

No. The server only interacts with the configured PlantUML server to generate/encode/decode diagrams; no authentication or persistent storage is mentioned.

What transport protocol does the server use?

It uses the standard Model Context Protocol (MCP) for communication with Claude clients; no custom transports are specified.

Frequently asked questions

What tools does PlantUML-MCP-Server provide?

It provides three tools: `generate_plantuml_diagram` to create diagrams with SVG/PNG URLs, `encode_plantuml` to convert PlantUML code into an encoded string, and `decode_plantuml` to reverse the encoding.

How do I configure a custom PlantUML server?

Set the `PLANTUML_SERVER_URL` environment variable to your server’s URL when adding the MCP server to Claude Desktop or Claude Code (default is `https://www.plantuml.com/plantuml`).

What are the runtime requirements?

Node.js 18+ and npm are required for local installation. The server runs via `npx` without local installation for normal use.

Does this server store any data or require authentication?

No. The server only interacts with the configured PlantUML server to generate/encode/decode diagrams; no authentication or persistent storage is mentioned.

What transport protocol does the server use?

It uses the standard Model Context Protocol (MCP) for communication with Claude clients; no custom transports are specified.

Comments

Basic information

More Other MCP servers

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K