Diagrams MCP Server

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

Features

5 Diagram Tools for infrastructure, architecture, and flowcharts:

• Infrastructure Diagrams - 15+ providers (AWS, Azure, GCP, K8s, On-Prem, SaaS)

• 500+ Node Types - Compute, database, network, storage, security

• Custom Icons - Web URLs (HTTPS) and local files

• Flowcharts - 24 shapes for process diagrams

• Validation - Dry-run before generation

Advanced Capabilities:

• Multiple output formats (PNG, PDF, JPG, DOT)

• Cluster grouping with unlimited nesting

• Edge styling (colours, labels, line styles)

• Graphviz attribute customisation

Installation

System Requirements:

• Graphviz must be installed:

  • macOS: brew install graphviz

  • Ubuntu/Debian: sudo apt-get install graphviz

  • Windows: Download from https://graphviz.org/download/

IDEs

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:

• "Create an AWS 3-tier web application diagram with Route53, ELB, EC2 instances, and RDS"

• "Generate a Kubernetes microservices architecture with ingress, services, and pods"

• "Build a flowchart for a CI/CD pipeline with decision points"

• "Create a diagram using a custom icon from my company logo URL"

• "Show me all available AWS compute nodes"

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)

Discovery & Validation (2 tools)

Custom Icons

Web URL Icons

• HTTPS-only (HTTP rejected)

• 5MB file size limit

• 5-second download timeout

• Image format validation (PNG, JPG)

• Automatic caching (~/.diagrams_mcp/icon_cache)

Local File Icons

• Path validation (file must exist)

• Format validation

• Sandboxed execution

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. See LICENSE file for details.

Contributing

Contributions welcome via PRs! Please ensure:

1. Tests pass, and new ones are added if applicable

2. Code is linted & formatted

3. Type hints are included

4. Clear, actionable error messages are provided

Support

For issues and questions, please open an issue on GitHub.