Local-first MCP server for PlantUML and Mermaid diagrams with drift detection.
Connect Runs on your machine
claude mcp add diagrams-mcp-server -e PROJECT_ROOT=<PROJECT_ROOT> -e DIAGRAMS_DIR=<DIAGRAMS_DIR> -e PLANTUML_SERVER_URL=<PLANTUML_SERVER_URL> -e ALLOW_REMOTE_PLANTUML=<ALLOW_REMOTE_PLANTUML> -e DISABLE_REMOTE_PLANTUML=<DISABLE_REMOTE_PLANTUML> -- npx -y [email protected]{
"mcpServers": {
"diagrams-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"PROJECT_ROOT": "<PROJECT_ROOT>",
"DIAGRAMS_DIR": "<DIAGRAMS_DIR>",
"PLANTUML_SERVER_URL": "<PLANTUML_SERVER_URL>",
"ALLOW_REMOTE_PLANTUML": "<ALLOW_REMOTE_PLANTUML>",
"DISABLE_REMOTE_PLANTUML": "<DISABLE_REMOTE_PLANTUML>"
}
}
}
}{
"mcpServers": {
"diagrams-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"PROJECT_ROOT": "<PROJECT_ROOT>",
"DIAGRAMS_DIR": "<DIAGRAMS_DIR>",
"PLANTUML_SERVER_URL": "<PLANTUML_SERVER_URL>",
"ALLOW_REMOTE_PLANTUML": "<ALLOW_REMOTE_PLANTUML>",
"DISABLE_REMOTE_PLANTUML": "<DISABLE_REMOTE_PLANTUML>"
}
}
}
}{
"servers": {
"diagrams-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"PROJECT_ROOT": "<PROJECT_ROOT>",
"DIAGRAMS_DIR": "<DIAGRAMS_DIR>",
"PLANTUML_SERVER_URL": "<PLANTUML_SERVER_URL>",
"ALLOW_REMOTE_PLANTUML": "<ALLOW_REMOTE_PLANTUML>",
"DISABLE_REMOTE_PLANTUML": "<DISABLE_REMOTE_PLANTUML>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
PROJECT_ROOTOptional | Project root to attach to (defaults to the working directory). |
DIAGRAMS_DIROptional | Diagrams directory, relative to PROJECT_ROOT unless absolute (default: diagrams). |
PLANTUML_SERVER_URLOptional | Override for the opt-in remote PlantUML fallback. |
ALLOW_REMOTE_PLANTUMLOptional | Set to true to allow the remote PlantUML fallback when no local CLI is installed. |
DISABLE_REMOTE_PLANTUMLOptional | Set to true to always disable the remote PlantUML fallback. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 19 Oct 2026 |
| Last updated | 19 Oct 2026 |
| Registry name | io.github.mohammad-emad-dev/diagrams-mcp-server |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.