diagram-master

MCP Draw.io Diagram Server

A Model Context Protocol (MCP) server that generates Draw.io compatible diagrams from natural language prompts. This server enables AI assistants to create professional diagrams in XML format that can be opened directly in Draw.io.

Features

• Unified Interface: Single tool (create_diagram) for all diagram types
• Flowchart Generation: Create sequential flowcharts with automatic hierarchical layout and branching support
• Sequence Diagrams: Generate professional UML sequence diagrams with lifelines and activation bars
• Entity Relationship Diagrams (ERD): Create database schemas with entities and relationships
• Network Diagrams: Build network and architecture diagrams with custom node positioning
• Custom Diagrams: Full control over shapes, positions, and connections for any diagram type
• Draw.io Compatible: Outputs valid Draw.io XML format that can be imported directly

Installation

• Clone or download this repository
• Install dependencies:

npm install

Configuration

Environment Variables

• DRAWIO_OUTPUT_DIR: (Optional) Specifies the directory where diagram files will be saved. If not set, files are saved to the current working directory.

Example:

export DRAWIO_OUTPUT_DIR=/path/to/diagrams  # Linux/macOS
set DRAWIO_OUTPUT_DIR=C:\diagrams          # Windows

Usage with Claude Desktop

Add this server to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Basic Configuration

{
  "mcpServers": {
    "diagram-master": {
      "command": "node",
      "args": ["D:\\TopSecret\\diagram-master\\index.js"]
    }
  }
}

With Custom Output Directory

{
  "mcpServers": {
    "diagram-master": {
      "command": "node",
      "args": ["D:\\TopSecret\\diagram-master\\index.js"],
      "env": {
        "DRAWIO_OUTPUT_DIR": "C:\\Users\\YourName\\Documents\\Diagrams"
      }
    }
  }
}

Make sure to update the paths to match your actual installation directory and desired output location.

Available Tools

create_diagram

Creates a diagram of the specified type and saves it to a file.

Parameters:

• filename: Name for the output .drawio file (extension added automatically)
• type: Type of diagram to generate (flowchart, sequence, network, erd, custom)
• data: Object containing diagram-specific data

1. Flowchart

Data Structure:

• steps: Array of steps (id, label, type)
• connections: Array of connections (from, to, label)

Example:

{
  "type": "flowchart",
  "filename": "login-flow",
  "data": {
    "steps": [
      { "id": "start", "label": "Start", "type": "terminator" },
      { "id": "input", "label": "Input Credentials", "type": "data" },
      { "id": "check", "label": "Valid?", "type": "decision" },
      { "id": "end", "label": "End", "type": "terminator" }
    ],
    "connections": [
      { "from": "start", "to": "input" },
      { "from": "input", "to": "check" },
      { "from": "check", "to": "end", "label": "Yes" },
      { "from": "check", "to": "input", "label": "No" }
    ]
  }
}

2. Sequence Diagram

Data Structure:

• participants: Array of participant names
• interactions: Array of interactions (from, to, message, dashed)

Example:

{
  "type": "sequence",
  "filename": "api-call",
  "data": {
    "participants": ["Client", "Server", "DB"],
    "interactions": [
      { "from": "Client", "to": "Server", "message": "Request" },
      { "from": "Server", "to": "DB", "message": "Query" },
      { "from": "DB", "to": "Server", "message": "Result", "dashed": true },
      { "from": "Server", "to": "Client", "message": "Response", "dashed": true }
    ]
  }
}

3. Entity Relationship Diagram (ERD)

Data Structure:

• entities: Array of entities (id, name, attributes)
• relationships: Array of relationships (from, to, label)

Example:

{
  "type": "erd",
  "filename": "schema",
  "data": {
    "entities": [
      { "id": "users", "name": "Users", "attributes": ["id", "email", "password"] },
      { "id": "posts", "name": "Posts", "attributes": ["id", "user_id", "title"] }
    ],
    "relationships": [
      { "from": "users", "to": "posts", "label": "1:N" }
    ]
  }
}

4. Network Diagram

Data Structure:

• nodes: Array of nodes (id, label, type, x, y)
• connections: Array of connections (from, to, label)

5. Custom Diagram

Data Structure:

• shapes: Array of shapes (id, label, type, x, y, width, height)
• connectors: Array of connectors (from, to, label)

Output Format

The server automatically saves diagrams as .drawio files in the configured output directory. Open these files directly in Draw.io.

Development

Project Structure

diagram-master/
├── index.js              # MCP server implementation
├── drawio-generator.js   # Draw.io XML generation utilities
├── package.json          # Project dependencies
├── README.md            # This file
├── CHANGELOG.md         # Version history
└── LICENSE              # MIT License

License

MIT

Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

Roadmap

Future enhancements:

• Class diagrams and State machines
• Style customization (colors, fonts, line styles)
• Export to multiple formats (PNG, SVG, PDF)