PlantUML
Converts PlantUML snippets into shareable diagrams with support for capability landscapes, business scenarios, and ArchiMate diagrams. Supports HTTP, SSE, and STDIO transports for integration with Claude Desktop, Flowise, and other MCP-compatible run
What is PlantUML?
PlantUML is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to converts plantuml snippets into shareable diagrams with support for capability landscapes, business scenarios, and archimate diagrams. supports http, sse, and stdio transports for integration with cla...
Converts PlantUML snippets into shareable diagrams with support for capability landscapes, business scenarios, and ArchiMate diagrams. Supports HTTP, SSE, and STDIO transports for integration with Claude Desktop, Flowise, and other MCP-compatible run
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Converts PlantUML snippets into shareable diagrams with supp
Use Cases
Maintainer
Works with
Installation
NPM
npx -y plantuml-mcp-serverManual Installation
npx -y plantuml-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use PlantUML
The PlantUML MCP Server by Infobip converts PlantUML diagram notation into shareable image URLs and optionally saves diagrams to disk, bringing visual architecture diagramming directly into AI assistant conversations. It exposes tools to generate, encode, and decode PlantUML diagrams using a configurable rendering server (defaulting to the public plantuml.com service), and supports HTTP, SSE, and STDIO transports for compatibility with Claude Desktop, Flowise, and other MCP-compatible runtimes. Teams that document systems with UML, ArchiMate, or capability landscape diagrams can use this server to let Claude generate and iterate on diagrams through natural language.
Prerequisites
- Node.js 18 or higher installed
- An MCP-compatible client such as Claude Desktop or Claude Code
- Access to a PlantUML rendering server (the public https://www.plantuml.com/plantuml works by default with no account needed)
- Optional: a self-hosted PlantUML server if you need private diagram rendering
Install the package
The server is available on npm and can be run directly with npx — no global install required.
npx -y plantuml-mcp-serverSet the PlantUML server URL (optional)
By default the server uses the public plantuml.com renderer. To use a self-hosted instance, set the PLANTUML_SERVER_URL environment variable in your MCP client config.
PLANTUML_SERVER_URL=https://www.plantuml.com/plantumlConfigure allowed save directories (optional)
If you want Claude to save generated diagrams to disk, set PLANTUML_ALLOWED_DIRS to a colon-separated list of permitted paths, or use '*' to allow any directory.
PLANTUML_ALLOWED_DIRS=/Users/yourname/diagrams:/Users/yourname/docsAdd the server to your MCP client
Add the server configuration to claude_desktop_config.json (Claude Desktop) or use the Claude Code CLI command.
{
"mcpServers": {
"plantuml": {
"command": "npx",
"args": ["plantuml-mcp-server"],
"env": {
"PLANTUML_SERVER_URL": "https://www.plantuml.com/plantuml",
"PLANTUML_ALLOWED_DIRS": "*"
}
}
}
}Restart your MCP client
Restart Claude Desktop (or reload the MCP server in your client) so it discovers the plantuml server and its three tools.
PlantUML Examples
Client configuration
Complete claude_desktop_config.json entry for the PlantUML MCP Server using the public rendering endpoint.
{
"mcpServers": {
"plantuml": {
"command": "npx",
"args": ["plantuml-mcp-server"],
"env": {
"PLANTUML_SERVER_URL": "https://www.plantuml.com/plantuml",
"PLANTUML_ALLOWED_DIRS": "*"
}
}
}
}Prompts to try
Example prompts for generating diagrams with the PlantUML MCP Server.
- "Generate a PlantUML sequence diagram showing the OAuth 2.0 authorization code flow"
- "Create a class diagram for a simple e-commerce system with Product, Order, and Customer classes"
- "Draw an ArchiMate capability landscape for a retail banking platform and give me a shareable link"
- "Convert this PlantUML snippet into a diagram and save it to /Users/me/docs/architecture.png"
- "Decode this PlantUML URL and show me the source notation: https://www.plantuml.com/plantuml/png/SoWkIImgAStDuNBAJrBGjLDmpCbCJbMmKiX8pSd9vt98pKi1IW80"Troubleshooting PlantUML
Diagram returns a blank or error image
PlantUML syntax errors produce an error image rather than throwing an exception. Ask Claude to use the check_plantuml_syntax or plantuml_error_handling prompt to validate the syntax before rendering, then correct any reported issues.
save_diagram tool returns a permission error
The target directory must be included in PLANTUML_ALLOWED_DIRS. Either add the specific path or set PLANTUML_ALLOWED_DIRS=* to allow any directory. Restart the MCP server after changing the environment variable.
Server not found after npm install
Ensure you are using Node.js 18 or higher ('node --version'). If npx caches an old version, clear the cache with 'npx clear-npx-cache' and try again.
Frequently Asked Questions about PlantUML
What is PlantUML?
PlantUML is a Model Context Protocol (MCP) server that converts plantuml snippets into shareable diagrams with support for capability landscapes, business scenarios, and archimate diagrams. supports http, sse, and stdio transports for integration with claude desktop, flowise, and other mcp-compatible run It connects AI assistants to external tools and data sources through a standardized interface.
How do I install PlantUML?
Install via npm with the command: npx -y plantuml-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with PlantUML?
PlantUML works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is PlantUML free to use?
Yes, PlantUML is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
PlantUML Alternatives — Similar Business Applications Servers
Looking for alternatives to PlantUML? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up PlantUML in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use PlantUML?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.