PlantUML

Provides an MCP server that generates PlantUML diagrams, encodes and decodes PlantUML, and saves diagrams locally.

javascript

25

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "infobip-plantuml-mcp-server": {
      "command": "npx",
      "args": [
        "plantuml-mcp-server"
      ],
      "env": {
        "PLANTUML_SERVER_URL": "https://www.plantuml.com/plantuml",
        "PLANTUML_ALLOWED_DIRS": "/home/user/diagrams:/tmp/output"
      }
    }
  }
}

PlantUML MCP Server provides a ready-to-use MCP server that generates PlantUML diagrams, encodes and decodes PlantUML strings, and can save diagrams locally. It acts as an intermediary so Claude-enabled clients can produce embeddable diagrams and manage PlantUML workflows directly within your MCP environment.

How to use

Once you have the PlantUML MCP Server running in your Claude environment, you can request a variety of PlantUML capabilities from Claude. Generate diagrams and obtain embeddable SVG/PNG URLs, create sequence or class diagrams, and leverage advanced PlantUML features like !include directives or external libraries. You can also encode PlantUML code for sharing in URLs and save diagrams locally with restricted paths for security.

How to install

Prerequisites: you need Node.js 18 or newer and npm installed on your system.

Claude Code setup (using a default PlantUML server):

# Install and activate the PlantUML MCP server for Claude Code
claude mcp add plantuml --scope user --env PLANTUML_SERVER_URL=https://www.plantuml.com/plantuml -- npx plantuml-mcp-server

Claude Desktop setup (MCP config JSON):

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

To use your own PlantUML server, modify the PLANTUML_SERVER_URL environment variable in the MCP setup and restart Claude Desktop/Code to activate the MCP server.

Additional configuration and notes

Diagram saving: you can save generated diagrams locally. By default, saving is restricted to the current working directory and only SVG or PNG files are allowed. To permit other locations, set PLANTUML_ALLOWED_DIRS in your environment (colon-separated paths or a wildcard).

Environment variables you may configure include PLANTUML_SERVER_URL, which points to the PlantUML server you want to use, and PLANTUML_ALLOWED_DIRS, which controls where output files may be saved.

Available tools

generate_plantuml_diagram

Generate PlantUML diagrams and receive embeddable SVG/PNG URLs, with options to save locally.

encode_plantuml

Encode PlantUML code into a compact string suitable for URL sharing.

decode_plantuml

Decode PlantUML strings back into their original PlantUML source.