MCP 服务器

Diagrams MCP Server

Enables creation of infrastructure and architecture diagrams as code using the Python diagrams library, supporting 15+ cloud providers, 500+ node types, custom icons, and flowcharts with multiple output formats.

README

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)

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