Log inSubmit server
Diagrams MCP logo

Diagrams MCP

Renders cloud, flowchart, sequence, and UML diagrams through diagrams, Mermaid, and PlantUML.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Diagrams MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": [
        "diagrams-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx diagrams-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 8d ago.

Overview

Diagrams MCP MCP server renders cloud architecture, flowchart, sequence, class, state, and UML diagrams through MCP tools. It uses mingrammer/diagrams with Graphviz, Mermaid CLI, or PlantUML depending on the selected renderer. Discovery tools expose providers, services, nodes, and cross-provider equivalents before rendering. Reach for it when an MCP client needs to generate infrastructure or software diagrams from structured descriptions or diagram definitions.

Use cases

  • Generate AWS architecture diagrams from Python diagram code
  • Render Mermaid flowcharts and sequence diagrams
  • Create PlantUML UML and deployment diagrams
  • Compare equivalent services across cloud providers

Key features

  • Render cloud architecture diagrams with mingrammer/diagrams
  • Render Mermaid definitions as PNG or SVG
  • Render PlantUML definitions as PNG
  • Discover providers, services, and node classes
  • Search infrastructure nodes by keyword
  • Map equivalent services across providers

Tools12

What Diagrams MCP lets your agent do. Expand a tool for its parameters.

Self-reported~17 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · diagrams-mcp-server (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
Last commit27d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed12Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Diagrams MCP works

What the Diagrams MCP MCP server does

Diagrams MCP generates diagram images from an MCP client. It supports cloud architecture diagrams through the Python-based mingrammer/diagrams library, as well as general diagram definitions written for Mermaid and PlantUML. The available output includes infrastructure layouts, flowcharts, sequence diagrams, class diagrams, entity-relationship diagrams, state diagrams, Gantt charts, deployment diagrams, and other formats supported by the selected engine.

The Diagrams MCP MCP server can work with providers and service categories such as AWS, GCP, Azure, Kubernetes, and on-premises infrastructure. Its discovery operations help an agent identify provider names, service groups, node classes, and import paths before it creates a cloud diagram. Cross-provider lookups can also map an infrastructure node to an equivalent service in another provider, such as AWS EC2 and GCP ComputeEngine.

How it works

Cloud diagrams are generated by executing diagrams-library Python code in a subprocess and returning a rendered image. Mermaid definitions are processed separately and can produce PNG or SVG output. PlantUML definitions produce PNG output and cover UML-oriented diagram types.

The server also exposes MCP resources containing reference material for diagram constructors, edges, clusters, Mermaid syntax, and PlantUML syntax. These resources give an agent examples and parameter guidance without requiring the information to be embedded in every prompt.

For hosted deployments, the MCP process can run as a facade and send rendering work to a separate HTTP renderer service. This arrangement keeps Graphviz, Chromium, Mermaid CLI, Java, and PlantUML in the renderer environment rather than the always-on facade process.

Setup and configuration

The local stdio installation can use uvx diagrams-mcp-server, a package installed with pip, or a source checkout. Graphviz is needed for local cloud architecture rendering. Mermaid CLI is needed for local Mermaid rendering, while PlantUML requires Java and the PlantUML JAR. These dependencies are engine-specific rather than all being required for every use case.

Claude Desktop, Claude Code, Cursor, Windsurf, and VS Code can launch the server with the documented stdio configurations. Remote facade mode uses FASTMCP_TRANSPORT, FASTMCP_HOST, and FASTMCP_PORT, together with DIAGRAMS_RENDERER_MODE=remote and DIAGRAMS_RENDERER_URL. DIAGRAMS_IMAGE_STORE_DIR can specify a temporary image directory, and BASE_URL can provide a public base URL for absolute download links.

Tools and capabilities

The Diagrams MCP MCP server provides these documented operations:

  • Discover providers, provider services, node classes, and nodes matching a search query.
  • Render mingrammer/diagrams Python code as a cloud architecture image.
  • Render Mermaid definitions as PNG or SVG.
  • Render PlantUML definitions as PNG.
  • Find equivalent infrastructure nodes across providers.
  • List infrastructure role categories and their mapped nodes.

The listed provider and node examples include aws, gcp, k8s, azure, onprem, compute, database, network, EC2, and ComputeEngine. The exact available nodes come from the supported diagrams provider library and can be inspected through discovery tools.

Limitations and notes

Local rendering depends on external binaries. Installing only Graphviz does not provide Mermaid or PlantUML rendering, and Mermaid or PlantUML dependencies are unnecessary if those engines are not used. The server does not itself replace the underlying diagrams, Mermaid, or PlantUML syntax; agents still need to supply valid code or definitions for the chosen renderer.

Remote mode requires a separately running renderer service and a reachable renderer URL. The repository includes Docker and Railway configuration examples for the facade and renderer roles, but deployment details depend on the hosting environment.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Diagrams MCP

Diagrams MCP is an MCP server that connects AI clients to cloud architecture and general diagram rendering through mingrammer/diagrams, Mermaid, and PlantUML. Its main tools discover providers and nodes, render diagram definitions, and find equivalent infrastructure services across cloud providers such as AWS and GCP.

Install it with `uvx diagrams-mcp-server` or `pip install diagrams-mcp-server`, then add the command to your MCP client configuration. Graphviz is required for local cloud architecture rendering; Mermaid CLI, Java, and PlantUML are needed only for their respective renderers.

Yes, Diagrams MCP works with Cursor through a stdio entry in `.cursor/mcp.json`. The documented configuration launches `diagrams-mcp-server` directly or through `uvx diagrams-mcp-server`; local rendering still requires the dependencies for the selected diagram engine.

Yes, it provides separate Mermaid and PlantUML rendering tools. Mermaid output can be PNG or SVG, while PlantUML output is PNG. Mermaid CLI is required for local Mermaid rendering, and PlantUML requires Java plus the PlantUML JAR.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDiagrams MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/diagrams-mcp?style=directory)](https://allmcps.com/mcp/diagrams-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/diagrams-mcp"><img src="https://allmcps.com/api/badge/diagrams-mcp?style=directory" alt="Diagrams MCP on AllMCPs" /></a>