Diagrams generates infrastructure and architecture diagrams as code using the Python diagrams library. Key capabilities: - Infrastructure diagrams for 15+ providers including AWS, Azure, GCP, Kubernetes, On-Premises, and SaaS platforms - 500+ node types spanning compute, database, network, storage, and security resources - Flowchart creation with 24 shapes for process visualization - Custom icon support via HTTPS URLs and local image files - Multiple output formats: PNG, PDF, JPG, and DOT - Advanced layout features including cluster grouping with unlimited nesting, styled edges (colors, labels, line styles), and Graphviz attribute customization - Dry-run validation to preview diagrams before generation

Diagrams MCP Server

MCP server for generating infrastructure and architecture diagrams as code using the Python diagrams library.

[](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://smithery.ai/server/@apetta/diagrams-mcp)

Features

5 Diagram Tools for infrastructure, architecture, and flowcharts:

Advanced Capabilities:

Installation

System Requirements:

IDEs

[](vscode:mcp/install?%7B%22name%22%3A%22diagrams%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22diagrams-mcp%22%5D%7D)

[](https://cursor.com/en-US/install-mcp?name=diagrams&config=eyJjb21tYW5kIjoidXZ4IGRpYWdyYW1zLW1jcCJ9)

Claude Desktop

Add to your claude_desktop_config.json:

For published package:

{
  "mcpServers": {
    "diagrams": {
      "command": "uvx",
      "args": ["diagrams-mcp"]
    }
  }
}

For local development:

{
  "mcpServers": {
    "diagrams:local": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/diagrams-mcp",
        "run",
        "diagrams-mcp"
      ]
    }
  }
}

Claude Code

Quick setup (CLI):

Published package:

claude mcp add --transport stdio math -- uvx diagrams-mcp

Local development:

claude mcp add --transport stdio math -- uvx --from /absolute/path/to/diagrams-mcp diagrams-mcp

Team setup (project-level):

Add .mcp.json to your project root:

{
  "mcpServers": {
    "diagrams": {
      "command": "uvx",
      "args": ["diagrams-mcp"]
    }
  }
}

Verify installation:

claude mcp list

Or check in IDE: View → MCP Servers, or use /mcp command.

Try It

Once installed, try these prompts:

Map to tools: create_diagram, create_diagram_with_custom_icons, create_flowchart, list_available_nodes, validate_diagram_spec

Tool Reference

All tool parameters and descriptions are available in your IDE's autocomplete.

Diagram Generation (3 tools)

| Tool | Description | | ---------------------------------- | ------------------------------------------------------------ | | create_diagram | Full infrastructure/architecture diagrams with all providers | | create_diagram_with_custom_icons | Diagrams with custom node icons from URLs or local files | | create_flowchart | Simplified flowchart creation with 24 process shapes |

Discovery & Validation (2 tools)

| Tool | Description | | ----------------------- | ------------------------------------------------------------- | | list_available_nodes | Search 500+ available nodes by provider, category, or keyword | | validate_diagram_spec | Dry-run validation before generation |

Custom Icons

Web URL Icons

Local File Icons

Development

Running Tests

# Run all tests
uv run poe test

Development Modes

STDIO mode (for Claude Desktop integration):

uv run diagrams-mcp

HTTP mode (for containerised deployments):

uv run diagrams-mcp-http --port 8000

License

MIT License.