🎨 Draw.io MCP Server¶

Pre-Release Alpha Software

This software is in pre-release alpha. Please open issues at github.com/aws-samples/sample-drawio-mcp/issues — we welcome bug reports and accept PRs.

Create, read, and update draw.io diagrams programmatically using AI assistants.

🚀 What is This?¶

The draw.io MCP server enables AI assistants to build technical diagrams on your local computer through natural language. Ask for an AWS architecture diagram, a flowchart, or a network topology—and watch it appear in draw.io format.

🏗️ Architecture¶

The project consists of two main components:

DrawIO JSAPI - A JavaScript/TypeScript library that manipulates mxGraph XML structures
MCP Server - A Model Context Protocol server that exposes diagram operations to AI assistants

The JSAPI operates independently of draw.io or mxGraph runtime dependencies, working in both Node.js and browser environments.

🔒 Privacy First¶

All operations run entirely on your local machine. No diagram data, telemetry, or information is transmitted over the network.

✨ Key Features¶

📊 Create architecture diagrams with AWS, Kubernetes, and more icons!
🔄 Programmatically modify existing diagrams
🎯 Natural language diagram creation through AI assistants
🌐 Works in Node.js and browser environments
🔐 100% local operation with no network dependencies

🎯 Quick Example¶

You: "Create an AWS serverless architecture diagram with CloudFront, API Gateway,
container-based Lambda (pulling from ECR), connecting to Aurora PostgreSQL,
OpenSearch, S3, and Bedrock. Include Cognito for authentication, IAM roles,
and CodePipeline for deployment. Show the VPC and private subnet structure."

AI: [Generates a properly formatted draw.io diagram with official AWS icons]

AWS Native Architecture

Example AWS architecture diagram generated by the MCP server. The resulting .drawio file can be edited manually in draw.io or programmatically by AI assistants like Kiro.

Getting Started¶

MCP Client Configuration¶

Add to your MCP client config (Claude Desktop, Claude Code, Kiro):

{
  "mcpServers": {
    "drawio": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aws-samples/sample-drawio-mcp/releases/latest/download/drawio-mcp-server-latest.tgz",
        "--no-cache"
      ],
      "type": "stdio"
    }
  }
}

See the full Installation Guide for version pinning, platform-specific config paths, and building from source.

📚 Documentation¶

JSAPI - JavaScript API documentation for programmatic diagram creation
Examples - Working code examples and tutorials
Contributing - Guidelines for contributing to the project