[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_109":110},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@byteoverdev/diagrams-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"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","dev-tools","status","published","metaDescription","metaKeywords","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",1781499744000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.mskry%2Fdiagrams-mcp-server","sourceVerified",false,"importedAt","upstreamStars",2,"upstreamUpdatedAt",1781071568000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","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 core diagram rendering engine. Mermaid CLI and PlantUML are optional — install them only if you need those specific rendering engines.\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 has all dependencies pre-installed. Local prerequisites only apply if you're running the server 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## 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,"categoryDisplayName","Developer Tools","upstream",{"_95":96,"_97":-5,"_98":99,"_100":101,"_102":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[103,104,105,106,107,108],"license","language","Python","registryName","io.github.mskry/diagrams-mcp-server","homepage","diagrams","mcp","mcp-server","mermaid-js","mingrammer","plantuml","ENV",{"_111":112,"_113":114,"_115":116},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]