Enables generation of Kubernetes architecture diagrams including ingress, services, pods, and other Kubernetes infrastructure components as part of the diagrams library's 15+ supported providers.
Uses the Python diagrams library to generate infrastructure and architecture diagrams as code, supporting 500+ node types across multiple cloud and infrastructure providers.
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 graphvizUbuntu/Debian:
sudo apt-get install graphvizWindows: Download from https://graphviz.org/download/
IDEs
Claude Desktop
Add to your claude_desktop_config.json:
For published package:
For local development:
Claude Code
Quick setup (CLI):
Published package:
Local development:
Team setup (project-level):
Add .mcp.json to your project root:
Verify installation:
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 |
| Full infrastructure/architecture diagrams with all providers |
| Diagrams with custom node icons from URLs or local files |
| Simplified flowchart creation with 24 process shapes |
Discovery & Validation (2 tools)
Tool | Description |
| Search 500+ available nodes by provider, category, or keyword |
| Dry-run validation before generation |
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
Development Modes
STDIO mode (for Claude Desktop integration):
HTTP mode (for containerised deployments):
License
MIT License. See LICENSE file for details.
Contributing
Contributions welcome via PRs! Please ensure:
Tests pass, and new ones are added if applicable
Code is linted & formatted
Type hints are included
Clear, actionable error messages are provided
Support
For issues and questions, please open an issue on GitHub.
