绘图自动化服务器

drawio mcp服务器

蟒蛇 模型上下文协议（MCP）服务器 用于生成和维护 draw.io架构图以编程方式绘制.

该项目使人工智能助手和自动化工具能够 读取、修改和生成draw.io图表 使用结构化命令，无需手动编辑XML。

长期目标是 供应商中立、网络感知的自动化层 用于基础设施架构图。

为什么这个项目存在

大型基础设施图，尤其是 网络架构图 --很快变得难以手动维护。

此MCP服务器允许图表：

• 从YAML拓扑模型以编程方式生成
• 通过自动化进行更新
• 由AI助手修改
• 类似代码的版本控制

图表被描述为数据并可重复生成，而不是手动编辑XML或在GUI中拖动形状。

YAML topology model
       │
       ▼
AI Assistant (Claude)
       │  MCP
       ▼
drawio-mcp-server
       │
       ▼
.drawio diagram files

v1.6.0的新增功能

多集群容器编排支持

新 build_multi_cluster 该工具生成一个Rancher管理平面，该平面连接到N个下游Kubernetes或OpenShift集群，每个集群都有控制平面、worker和容纳工作负载链的命名空间/项目容器。

• 牧场主管理乐队 manage 每个集群的链接（可选）
• 每个集群平台： k8s 或 openshift --OpenShift正确地省略了单独的etcd行
• 命名空间(k8s)/项目(openshift)带有工作负载对象的容器
• 自动排序的工作负载流链：入口/路由→ 服务→ 部署/吊舱
• 通过YAML驱动 topology: multi_cluster

新验证码

E015 不良平台· E016 零控制平面节点· E017 零工作节点· E018 重复的群集名称· E019 不良工作负载类型· W009 Rancher已禁用多个集群· W010 未声明集群

v1.5.0的新增功能

多站点架构支持

新 build_multi_site 该工具在单个呼叫中生成由DCI/互连频带连接的N站点骨干叶结构。

• 每个站点可配置的脊椎计数、叶子计数和可选的计算行数
• 支持的互连类型： evpn, vxlan, ospf, bgp, static
• 每个频带可配置的DCI/路由反射器节点数
• 每个站点内的全网脊到叶布线
• 脊椎和DCI节点之间的自动跨站点上行链路布线
• 通过YAML驱动 topology: multi_site

新验证码

E011 重复站点名称· E012 不支持的互连类型· E013 零刺· E014 零叶· W007 未声明互连· W008 少于2个站点

特性

核心图操作（v1.0.0）

• 读取和写入原始draw.io XML
• 列出图表节点和边
• 添加、更新和删除节点
• 在节点之间创建连接
• 创建空白图表
• 自动布局（TB/BT/LR/RL）

网络感知原语（v1.1.0）

• add_device() --添加具有语义角色的设备（脊椎、叶子、防火墙、gpunode等）
• add_link() --添加键入链接（结构、上行链路、管理）
• build_spine_leaf_fabric() --生成完整的脊椎叶拓扑

数据/YAML模型图（v1.2.0）

• build_diagram_from_model() --从YAML文件构建完整的图表
• 样式配置文件： minimal, enterprise, dark, vendor-neutral
• 使用结构化JSON错误报告进行完全验证

容器和扩展拓扑（v1.3.0）

• add_container() --逻辑容器组（机架、区域、集群）
• group_nodes() --通过边界框将现有节点包装到容器中
• build_hub_spoke() --中心辐射拓扑（租户结构或广域网分支模式）
• build_security_stack() --5层安全区架构

测试套件和CI（v1.4.0）

• 234测试pytest套件，涵盖所有模块
• Python 3.11和3.12上的GitHub操作CI
• 覆盖门强制执行≥80%

多站点架构（v1.5.0）

• build_multi_site() --带DCI互连带的N位脊叶结构
• YAML支持 topology: multi_site
• 新的验证代码E011-E014、W007-W008

多集群容器编排（v1.6.0）

• build_multi_cluster() --Rancher管理平面+N个Kubernetes/OpenShift集群
• 具有自动排序工作负载流链的命名空间/项目容器
• YAML支持 topology: multi_cluster
• 新的验证代码E015-E019、W009-W010

快速入门：YAML→ 图表

单部位脊椎叶

meta:
  name: "DC1 Fabric"
  topology: spine_leaf
  style_profile: minimal

sites:
  - name: dc1

devices:
  - hostname: spine01
    role: spine
    site: dc1
  - hostname: leaf01
    role: leaf
    site: dc1
  - hostname: compute01
    role: compute_node
    site: dc1

links:
  - a: spine01
    b: leaf01
    type: fabric
  - a: leaf01
    b: compute01
    type: uplink

多站点EVPN结构

meta:
  name: "Multi-Site Fabric"
  topology: multi_site
  style_profile: minimal

sites:
  - name: dc1
    spines: 2
    leafs: 4
    compute_per_leaf: 2
  - name: dc2
    spines: 2
    leafs: 4

interconnect:
  type: evpn
  dci_nodes: 2

生成任一图表：

build_diagram_from_model(
    path="diagrams/fabric.drawio",
    yaml_path="examples/multi_site.yaml"
)

所有MCP工具--v1.6.0（20个工具）

高层建筑商

节点和链接图元

图表管理

支持的设备角色

支持的链接类型

样式配置文件

验证码

安装

git clone https://github.com/Eswarthemad/drawio-mcp-server.git
cd drawio-mcp-server

python -m venv venv

# Windows
venv\Scripts\activate

# Linux / macOS
source venv/bin/activate

pip install -r requirements.txt

开发（测试+梳理）：

pip install -r requirements-dev.txt
pytest tests/ -v

Claude桌面配置

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "drawio-mcp": {
      "command": "C:\\path\\to\\drawio-mcp-server\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\drawio-mcp-server\\server.py"]
    }
  }
}

保存后重新启动Claude Desktop。

项目结构

drawio-mcp-server/
├── server.py             MCP tool registration (20 tools)
├── drawio.py             XML engine and topology builders
├── models.py             YAML topology model dataclasses
├── styles.py             Style profile resolver
├── validators.py         Model validation (E001–E019, W001–W010)
├── requirements.txt      Runtime dependencies
├── requirements-dev.txt  Dev dependencies (pytest, ruff)
├── examples/
│   ├── spine_leaf.yaml
│   ├── multi_site.yaml
│   └── multi_cluster.yaml
└── tests/
    ├── test_drawio.py
    ├── test_models.py
    ├── test_styles.py
    ├── test_validators.py
    ├── test_multisite.py
    └── test_multicluster.py

版本历史记录

路线图

• 支持多页图表（逻辑/物理/流量视图）
• VDOM架构构建器
• 其他拓扑示例
• CI覆盖门提高以匹配新的测试计数

贡献

看 贡献.md.

许可证

根据MIT许可证发布。