Draw.io MCP Server
Servidor MCP de Draw.io
Hagamos diagramas con estilo usando la herramienta de diagramación más extendida llamada Draw.io (Diagrams.net).
Aspectos destacados
Importación y exportación de diagramas desde/hacia XML, SVG (con XML incrustado) o PNG (con XML incrustado)
Control de geometría de bordes con puntos de referencia y enrutamiento automático de conectores
Relaciones padre-hijo para formas anidadas y agrupación
Servidor y extensión unificados en el mismo mono-repositorio
Editor de Draw.io integrado: no requiere extensión de navegador
Servidor MCP que permite a los agentes de IA controlar diagramas de Draw.io
Creación, inspección y modificación programática de diagramas mediante herramientas MCP
Gestión de capas para diagramas complejos
Funciona con cualquier cliente MCP (Claude Desktop, Claude Code, Zed, Codex, etc.)
Related MCP server: Draw.io MCP Server
Introducción
El servidor MCP de Draw.io aporta capacidades de diagramación de Draw.io a los agentes de IA. Proporciona herramientas MCP que pueden crear, leer, actualizar y eliminar elementos de diagramas, permitiendo a los asistentes de IA construir diagramas de arquitectura, diagramas de flujo y documentación visual automáticamente.
Dos formas de usarlo:
Editor integrado - El servidor aloja Draw.io directamente, accesible en su navegador
Extensión de navegador - Conéctese a Draw.io ejecutándose en su navegador mediante una extensión
Requisitos
Node.js (v20 o superior) - Entorno de ejecución para el servidor MCP
Cliente MCP - Claude Desktop, Claude Code, Zed, Codex, OpenCode o cualquier host compatible con MCP
Para el editor integrado
No se requieren requisitos adicionales: funciona directamente con la bandera --editor.
Para la extensión de navegador
Extensión de navegador - drawio-mcp-extension
Draw.io abierto en su navegador
Opcional
pnpm - Gestor de paquetes preferido (npm también funciona bien)
Inicio rápido
1. Configure su host MCP
Añada el servidor a la configuración de su cliente MCP:
Edite ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}claude mcp add-json drawio '{"type":"stdio","command":"npx","args":["-y","drawio-mcp-server","--editor"]}'Añada a ~/.config/zed/settings.json:
{
"context_servers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"],
"env": {}
}
}
}Edite ~/.codex/config.toml:
[mcp_servers.drawio]
command = "npx"
args = ["-y", "drawio-mcp-server", "--editor"]Añada a opencode.json en la raíz de su proyecto o en ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"drawio": {
"type": "local",
"command": ["npx", "-y", "drawio-mcp-server", "--editor"],
"enabled": true
}
}
}Para otros clientes MCP y configuración detallada (incluyendo opciones de pnpm), consulte Configuración.
2. Abra el editor
Después de reiniciar su host MCP, abra: http://localhost:3000/
3. Empiece a diagramar
Ejemplos de prompts que puede probar:
"Crea un diagrama de arquitectura basada en eventos que muestre una cola de mensajes con productores, consumidores y tres servicios backend"
"Dibuja un diagrama de API CRUD con una base de datos, una puerta de enlace de API y cuatro microservicios con sus puntos finales"
"Añade una nueva capa llamada 'Fondo' y mueve todos los elementos decorativos a ella, luego crea una nueva capa para anotaciones"
Su asistente de IA ahora puede controlar el diagrama usando herramientas MCP.
Características
El servidor proporciona herramientas MCP para:
Inspección de diagramas - leer formas, capas y propiedades de celdas
Modificación de diagramas - añadir/editar/eliminar formas, bordes y etiquetas
Gestión de capas - crear, cambiar y organizar capas
Consulte la Referencia de herramientas para obtener la lista completa de herramientas disponibles.
Instalación
El servidor se ejecuta como parte de su host MCP. La configuración detallada para todos los clientes compatibles (Claude Desktop, Claude Code, Zed, Codex, oterm), incluyendo opciones de npm y pnpm, está disponible en Configuración.
Alternativa: Extensión de navegador
En lugar del editor integrado, puede usar la extensión de navegador para conectarse a Draw.io ejecutándose en su navegador. Esto funciona con o sin la bandera --editor.
Instale la extensión de navegador Draw.io MCP:
Asegúrese de que la extensión esté conectada (superposición de señal verde en el icono)
Configuración sin --editor:
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}Consulte la documentación de la extensión para más detalles.
Recursos relacionados
Configuración - Banderas de CLI y opciones avanzadas
Referencia de herramientas - Documentación completa de herramientas MCP
Historial de estrellas
Evaluaciones

Available Tools
13 toolsadd-cell-of-shapeC
This tool allows you to add new vertex cell (object) on the current page of a Draw.io diagram by its shape name. It accepts multiple optional input parameter.
Inputs: shape_name (required), x, y, width, +3 more.
add-edgeC
This tool creates an edge, sometimes called also a relation, between two vertexes (cells).
Inputs: source_id (required), target_id (required), text, style.
add-rectangleC
This tool allows you to add new Rectangle vertex cell (object) on the current page of a Draw.io diagram. It accepts multiple optional input parameter.
Inputs: x, y, width, height, +2 more.
delete-cell-by-idC
Deletes a cell, whether it is a vertex or edge.
Inputs: cell_id (required).
edit-cellA
Update properties of an existing vertex/shape cell by its ID. Only provided fields are modified; unspecified properties remain unchanged.
Inputs: cell_id (required), text, x, y, +3 more.
edit-edgeA
Update properties of an existing edge by its ID. Only provided fields are modified; unspecified properties remain unchanged.
Inputs: cell_id (required), text, source_id, target_id, +1 more.
get-selected-cellB
This tool allows you to retrieve selected cell (whether vertex or edge) on the current page of a Draw.io diagram. The response is a JSON containing attributes of the cell.
Inputs: no named parameters.
get-shape-by-nameA
Retrieve a specific shape by its name from all available shapes in the diagram's library. It returns the shape and also the category it belongs.
Inputs: shape_name (required).
get-shape-categoriesB
Retrieves available shape categories from the diagram's library. Library is split into multiple categories.
Inputs: no named parameters.
get-shapes-in-categoryC
Retrieve all shapes in the provided category from the diagram's library. A shape primarily contains style based on which you can create new vertex cells.
Inputs: category_id (required).
list-paged-modelA
Retrieves a paginated view of all cells (vertices and edges) in the current Draw.io diagram. This tool provides access to the complete model data with essential fields only, sanitized to remove circular dependencies and excessive data. It allows to filter based on multiple criteria and attribute boolean logic. Useful for programmatic inspection of diagram structure without overwhelming response sizes.
Inputs: page, page_size, filter.
set-cell-dataC
Sets or updates a custom attribute on an existing cell.
Inputs: cell_id (required), key (required), value (required).
set-cell-shapeC
Updates the visual style of an existing vertex cell to match a library shape by name.
Inputs: cell_id (required), shape_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
The tools have clear purposes but some overlap exists, such as add-cell-of-shape and add-rectangle both adding vertex cells, which could cause confusion. However, descriptions help differentiate them by shape specificity, and most tools target distinct actions like editing, deleting, or retrieving cells.
Tool names follow a consistent verb_noun pattern with minor deviations, such as list-paged-model using 'paged' instead of a direct noun. Most names are clear and readable, like delete-cell-by-id and get-shape-by-name, maintaining a predictable structure throughout the set.
With 13 tools, the count is well-scoped for a diagram editing server, covering essential operations like adding, editing, deleting, and retrieving cells and shapes. Each tool earns its place by addressing specific needs in diagram manipulation without being overwhelming.
The toolset provides comprehensive coverage for diagram editing, including CRUD operations for cells and edges, shape management, and data inspection. Minor gaps exist, such as no direct tool for creating new pages or handling diagram-level properties, but agents can work around these with existing tools.
Maintenance
Related MCP Connectors
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Create, edit and organize hand-drawn diagrams (flowcharts, ER, architecture) from any AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create and edit draw.io diagrams programmatically, supporting a wide range of diagram types and styles.72 PyPI6MIT
- AlicenseCqualityDmaintenanceEnables AI models to create and manage various types of diagrams (flowcharts, UML, network diagrams, etc.) via the Model Context Protocol.266MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, modify, and analyze diagrams using Draw.io (Diagrams.net) through MCP commands.MIT
- FlicenseNot gradedqualityFmaintenanceEnables AI assistants to create, read, and manage Draw.io diagrams programmatically through natural language interactions.1-