[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_120":121},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":-5,"_81":-5,"_82":-5,"_83":49,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","byteoverdev","moduleId","diagrams-mcp","@byteoverdev/diagrams-mcp","displayName","Diagrams MCP","tagline","Generate cloud architecture diagrams, flowcharts, and sequence diagrams.","iconKey","https://avatars.githubusercontent.com/u/257649033?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://diagrams-mcp-production.up.railway.app/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363504000,"updatedAt",1788160320000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.mskry%2Fdiagrams-mcp-server","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",3,"upstreamUpdatedAt",1781939418000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt",1787549632000,"githubRepoUrl","https://github.com/ByteOverDev/diagrams-mcp","githubRepoFullName","ByteOverDev/diagrams-mcp","releaseId","ext-byteoverdev-diagrams-mcp","version","0.1.2","descriptionMarkdown","# diagrams-mcp-server\n\n[![PyPI](https://img.shields.io/pypi/v/diagrams-mcp-server)](https://pypi.org/project/diagrams-mcp-server/)\n[![CI](https://github.com/ByteOverDev/diagrams-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/ByteOverDev/diagrams-mcp/actions/workflows/ci.yml)\n[![Railway](https://img.shields.io/endpoint?url=https://diagrams-mcp-production.up.railway.app/health&logo=railway)](https://diagrams-mcp-production.up.railway.app/health)\n\nMCP server for generating cloud architecture diagrams, flowcharts, sequence diagrams, and more — powered by three rendering engines: [mingrammer/diagrams](https://github.com/mingrammer/diagrams), [Mermaid](https://mermaid.js.org/), and [PlantUML](https://plantuml.com/).\n\n![Example diagram](https://raw.githubusercontent.com/ByteOverDev/diagrams-mcp/main/assets/hero-diagram.png)\n\n## Getting Started\n\n### Hosted (Recommended)\n\nConnect to the public hosted server — no installation required. All rendering engines and dependencies are pre-installed.\n\n

Claude Desktop

\n\nAdd to your `claude_desktop_config.json` (`Settings` → `Developer` → `Edit Config`):\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"url\": \"https://diagrams-mcp-production.up.railway.app/mcp\"\n }\n }\n}\n```\n\n

\n\n

Claude Code (CLI)

\n\nRun:\n\n```bash\nclaude mcp add diagrams-mcp https://diagrams-mcp-production.up.railway.app/mcp\n```\n\nOr add to your `.mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"url\": \"https://diagrams-mcp-production.up.railway.app/mcp\"\n }\n }\n}\n```\n\n

\n\n

Cursor

\n\nAdd to your `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"url\": \"https://diagrams-mcp-production.up.railway.app/mcp\"\n }\n }\n}\n```\n\n

\n\n

Windsurf

\n\nAdd to your `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"serverUrl\": \"https://diagrams-mcp-production.up.railway.app/mcp\"\n }\n }\n}\n```\n\n

\n\n

VS Code

\n\nAdd to your `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"diagrams-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://diagrams-mcp-production.up.railway.app/mcp\"\n }\n }\n}\n```\n\n

\n\n### Local Installation\n\n#### Prerequisites\n\nGraphviz is required for the default local/in-process rendering mode. Mermaid CLI and PlantUML are optional — install them only if you need those specific rendering engines locally.\n\n| Dependency | Required for | Install |\n|---|---|---|\n| [Graphviz](https://graphviz.org/) | `render_diagram` (cloud architecture) | `brew install graphviz` |\n| [Mermaid CLI](https://github.com/mermaid-js/mermaid-cli) | `render_mermaid` (flowcharts, sequence, etc.) | `npm install -g @mermaid-js/mermaid-cli` |\n| [Java](https://openjdk.org/) + [PlantUML](https://plantuml.com/) | `render_plantuml` (UML diagrams) | `brew install openjdk` + download [plantuml.jar](https://github.com/plantuml/plantuml/releases) |\n\n> **Note**: The hosted server runs as a slim MCP facade plus a separate renderer service, and has all render dependencies pre-installed in the renderer. Local prerequisites only apply if you're running in-process rendering yourself.\n\n#### Install the server\n\n**Via uvx** (recommended):\n\n```bash\nuvx diagrams-mcp-server\n```\n\n**Via pip:**\n\n```bash\npip install diagrams-mcp-server\n```\n\n**From source:**\n\n```bash\npip install git+https://github.com/ByteOverDev/diagrams-mcp.git\n```\n\n#### Configure your MCP client\n\n

Claude Desktop

\n\nAdd to your `claude_desktop_config.json` (`Settings` → `Developer` → `Edit Config`):\n\n**uvx (recommended):**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"diagrams-mcp-server\"]\n }\n }\n}\n```\n\n**pip:**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"diagrams-mcp-server\"\n }\n }\n}\n```\n\n

\n\n

Claude Code (CLI)

\n\nRun:\n\n```bash\nclaude mcp add diagrams-mcp -- uvx diagrams-mcp-server\n```\n\nOr add to your `.mcp.json`:\n\n**uvx (recommended):**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"diagrams-mcp-server\"]\n }\n }\n}\n```\n\n**pip:**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"diagrams-mcp-server\"\n }\n }\n}\n```\n\n

\n\n

Cursor

\n\nAdd to your `.cursor/mcp.json`:\n\n**uvx (recommended):**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"diagrams-mcp-server\"]\n }\n }\n}\n```\n\n**pip:**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"diagrams-mcp-server\"\n }\n }\n}\n```\n\n

\n\n

Windsurf

\n\nAdd to your `~/.codeium/windsurf/mcp_config.json`:\n\n**uvx (recommended):**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"diagrams-mcp-server\"]\n }\n }\n}\n```\n\n**pip:**\n\n```json\n{\n \"mcpServers\": {\n \"diagrams-mcp\": {\n \"command\": \"diagrams-mcp-server\"\n }\n }\n}\n```\n\n

\n\n

VS Code

\n\nAdd to your `.vscode/mcp.json`:\n\n**uvx (recommended):**\n\n```json\n{\n \"servers\": {\n \"diagrams-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"diagrams-mcp-server\"]\n }\n }\n}\n```\n\n**pip:**\n\n```json\n{\n \"servers\": {\n \"diagrams-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"diagrams-mcp-server\"\n }\n }\n}\n```\n\n

\n\n## Available Tools\n\n### Discovery\n\n- `list_providers()` → `list[str]` — List all diagram providers (`aws`, `gcp`, `k8s`, `azure`, `onprem`, etc.)\n- `list_services(provider)` → `list[str]` — List service categories within a provider (e.g. `aws` → `compute`, `database`, `network`)\n- `list_nodes(provider, service)` → `list[dict]` — List node classes for a provider.service pair with import paths\n- `search_nodes(query)` → `list[dict]` — Search for nodes by keyword across all providers (e.g. \"postgres\", \"lambda\")\n\n### Rendering\n\n- `render_diagram(code)` → `Image` (PNG) — Execute a Python script using [mingrammer/diagrams](https://github.com/mingrammer/diagrams) in a sandboxed subprocess. Returns a rendered cloud architecture diagram.\n- `render_mermaid(definition)` → `Image` (PNG/SVG) — Render a [Mermaid](https://mermaid.js.org/) diagram definition (flowcharts, sequence, class, ER, state, Gantt, and more).\n- `render_plantuml(definition)` → `Image` (PNG) — Render a [PlantUML](https://plantuml.com/) diagram definition (sequence, class, component, activity, state, deployment).\n\n### Cross-Provider Equivalence\n\n- `find_equivalent(node, target_provider?)` → `dict` — Find equivalent services across cloud providers (e.g. `EC2` → `ComputeEngine` on GCP).\n- `list_categories()` → `list[dict]` — List all 30 infrastructure role categories with mapped nodes across providers.\n\n## Resources\n\nThe server provides reference documentation accessible via MCP resource URIs:\n\n| URI | Description |\n|---|---|\n| `diagrams://reference/diagram` | Diagram constructor parameters, defaults, and usage |\n| `diagrams://reference/edge` | Edge operators, labels, styling, and chaining |\n| `diagrams://reference/cluster` | Cluster nesting, styling, and graph attributes |\n| `diagrams://reference/mermaid` | Mermaid syntax examples for 6 diagram types |\n| `diagrams://reference/plantuml` | PlantUML syntax examples for 6 diagram types |\n\n## Examples\n\n### Cloud Architecture (mingrammer/diagrams)\n\n> \"Draw an AWS architecture with an ALB routing to two ECS services, backed by RDS and ElastiCache\"\n\n```python\nfrom diagrams import Diagram, Cluster\nfrom diagrams.aws.network import ALB\nfrom diagrams.aws.compute import ECS\nfrom diagrams.aws.database import RDS, ElastiCache\n\nwith Diagram(\"ECS Service\", direction=\"LR\"):\n lb = ALB(\"ALB\")\n\n with Cluster(\"ECS Cluster\"):\n services = [ECS(\"Web\"), ECS(\"API\")]\n\n lb >> services\n services[0] >> ElastiCache(\"Cache\")\n services[1] >> RDS(\"Database\")\n```\n\n### Flowchart (Mermaid)\n\n> \"Create a flowchart showing a CI/CD pipeline\"\n\n![Mermaid flowchart](https://raw.githubusercontent.com/ByteOverDev/diagrams-mcp/main/assets/mermaid-example.png)\n\n### Sequence Diagram (PlantUML)\n\n> \"Show the authentication flow between a client, API gateway, and auth service\"\n\n![PlantUML sequence diagram](https://raw.githubusercontent.com/ByteOverDev/diagrams-mcp/main/assets/plantuml-example.png)\n\n```plantuml\n@startuml\nClient -> \"API Gateway\": POST /login\n\"API Gateway\" -> \"Auth Service\": Validate credentials\n\"Auth Service\" --> \"API Gateway\": JWT token\n\"API Gateway\" --> Client: 200 OK + token\nClient -> \"API Gateway\": GET /data (Bearer token)\n\"API Gateway\" -> \"Auth Service\": Verify token\n\"Auth Service\" --> \"API Gateway\": Valid\n\"API Gateway\" --> Client: 200 OK + data\n@enduml\n```\n\n## Development\n\n```bash\n# Clone and install\ngit clone https://github.com/ByteOverDev/diagrams-mcp.git\ncd diagrams-mcp\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Lint and format\nruff check .\nruff format .\n\n# Run the MCP server locally (stdio mode)\ndiagrams-mcp-server\n```\n\n### Split Facade/Renderer Mode\n\nFor hosted deployments, the MCP server can run as a lightweight facade that delegates render work to a separate renderer service. This keeps the always-on MCP process small while Graphviz, Chromium, Mermaid CLI, Java, and PlantUML live only in the renderer image.\n\n```bash\n# Terminal 1: renderer service\nRENDERER_HOST=0.0.0.0 RENDERER_PORT=8001 diagrams-renderer-server\n\n# Terminal 2: HTTP MCP facade delegating to the renderer\nFASTMCP_TRANSPORT=http \\\nFASTMCP_HOST=0.0.0.0 \\\nFASTMCP_PORT=8000 \\\nDIAGRAMS_RENDERER_MODE=remote \\\nDIAGRAMS_RENDERER_URL=http://127.0.0.1:8001 \\\ndiagrams-mcp-server\n```\n\nDocker/Railway examples are included:\n\n| File | Purpose |\n|---|---|\n| `Dockerfile.facade` | Slim MCP facade image without renderer-only binaries |\n| `Dockerfile.renderer` | Renderer image with Graphviz, Chromium, Mermaid CLI, Java, and PlantUML |\n| `railway.facade.toml` | Example Railway facade service config |\n| `railway.renderer.toml` | Example Railway renderer service config |\n\nKey environment variables:\n\n| Variable | Purpose |\n|---|---|\n| `DIAGRAMS_RENDERER_MODE=remote` | Makes the facade use the HTTP renderer service |\n| `DIAGRAMS_RENDERER_URL` | Renderer base URL, for example `http://diagrams-renderer.railway.internal:8080` |\n| `DIAGRAMS_IMAGE_STORE_DIR` | Optional file-backed temporary image store directory |\n| `BASE_URL` | Optional public base URL used when returning absolute download links |\n\n## Supported Providers\n\nThe `render_diagram` tool supports all providers from the [mingrammer/diagrams](https://diagrams.mingrammer.com/docs/nodes/aws) library, including:\n\n**AWS**, **GCP**, **Azure**, **Kubernetes**, **On-Premise**, **AlibabaCloud**, **OCI**, **OpenStack**, **DigitalOcean**, **Elastic**, **Outscale**, **Generic**, and **Custom** nodes.\n\nUse `list_providers()` and `search_nodes(query)` to discover available nodes.\n\n## License\n\nMIT\n\n\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_103":104,"_105":-5,"_106":107,"_108":109,"_110":-5,"_111":112},"requiredSecrets",[],"tags",[99,100,101,102],"assets",[],"stats",{"_97":86,"_98":86},"ratingAvg","reviewCount","diagrams","mermaid-js","mingrammer","plantuml","topics",[99,118,119,100,101,102],"license","language","Python","registryName","io.github.mskry/diagrams-mcp-server","homepage","packages",[113],{"_114":115,"_116":117,"_76":77},"registryType","pypi","identifier","diagrams-mcp-server","mcp","mcp-server","ENV",{"_122":123,"_124":125,"_126":127},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]