Diagrams

diagrams-mcp-server

用于生成云架构图、流程图、时序图等的 MCP 服务，由三种渲染引擎提供支持：mingrammer/diagrams、Mermaid 和 PlantUML。

开始使用

本地安装

先决条件

默认的本地／进程内渲染模式需要 Graphviz。Mermaid CLI 和 PlantUML 是可选项——只有在需要在本地使用对应的渲染引擎时才安装。

安装服务

通过 uvx（推荐）：

uvx diagrams-mcp-server

通过 pip：

pip install diagrams-mcp-server

从源码安装：

pip install git+https://github.com/ByteOverDev/diagrams-mcp.git

配置 MCP 客户端

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

claude mcp add diagrams-mcp -- uvx diagrams-mcp-server

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

{
  "servers": {
    "diagrams-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "servers": {
    "diagrams-mcp": {
      "type": "stdio",
      "command": "diagrams-mcp-server"
    }
  }
}

可用工具

查询

• list_providers() → list[str] — 列出所有图表提供方（aws、gcp、k8s、azure、onprem 等）
• list_services(provider) → list[str] — 列出某个提供方中的服务类别（例如 aws → compute、database、network）
• list_nodes(provider, service) → list[dict] — 列出某个提供方与服务组合对应的节点类及其导入路径
• search_nodes(query) → list[dict] — 按关键字搜索所有提供方中的节点（例如 "postgres"、"lambda"）

渲染

• render_diagram(code) → Image (PNG) — 在沙盒子进程中执行使用 mingrammer/diagrams 的 Python 脚本。返回渲染后的云架构图。
• render_mermaid(definition) → Image (PNG/SVG) — 渲染 Mermaid 图表定义（流程图、时序图、类图、ER 图、状态图、甘特图等）。
• render_plantuml(definition) → Image (PNG) — 渲染 PlantUML 图表定义（时序图、类图、组件图、活动图、状态图、部署图）。

跨提供方等效项

• find_equivalent(node, target_provider?) → dict — 查找不同云提供方中的等效服务（例如 EC2 → GCP 上的 ComputeEngine）。
• list_categories() → list[dict] — 列出全部 30 种基础设施角色类别及各提供方中对应的节点。

资源

服务器通过 MCP 资源 URI 提供可访问的参考文档：

示例

云架构（mingrammer/diagrams）

“绘制一个 AWS 架构图，其中 ALB 将流量路由到两个 ECS 服务，并由 RDS 和 ElastiCache 提供支持”

from diagrams import Diagram, Cluster
from diagrams.aws.network import ALB
from diagrams.aws.compute import ECS
from diagrams.aws.database import RDS, ElastiCache

with Diagram("ECS Service", direction="LR"):
    lb = ALB("ALB")

    with Cluster("ECS Cluster"):
        services = [ECS("Web"), ECS("API")]

    lb >> services
    services[0] >> ElastiCache("Cache")
    services[1] >> RDS("Database")

流程图（Mermaid）

“创建一个展示 CI/CD 流水线的流程图”

时序图（PlantUML）

“展示客户端、API 网关和身份验证服务之间的身份验证流程”

@startuml
Client -> "API Gateway": POST /login
"API Gateway" -> "Auth Service": Validate credentials
"Auth Service" --> "API Gateway": JWT token
"API Gateway" --> Client: 200 OK + token
Client -> "API Gateway": GET /data (Bearer token)
"API Gateway" -> "Auth Service": Verify token
"Auth Service" --> "API Gateway": Valid
"API Gateway" --> Client: 200 OK + data
@enduml

开发

# Clone and install
git clone https://github.com/ByteOverDev/diagrams-mcp.git
cd diagrams-mcp
pip install -e ".[dev]"

# Run tests
pytest

# Lint and format
ruff check .
ruff format .

# Run the MCP server locally (stdio mode)
diagrams-mcp-server

外观层/渲染器拆分模式

对于托管部署，MCP 服务可以作为轻量级外观层运行，并将渲染工作委托给独立的渲染器服务。这样可以让常驻运行的 MCP 进程保持精简，同时仅在渲染器镜像中安装 Graphviz、Chromium、Mermaid CLI、Java 和 PlantUML。

# Terminal 1: renderer service
RENDERER_HOST=0.0.0.0 RENDERER_PORT=8001 diagrams-renderer-server

# Terminal 2: HTTP MCP facade delegating to the renderer
FASTMCP_TRANSPORT=http \
FASTMCP_HOST=0.0.0.0 \
FASTMCP_PORT=8000 \
DIAGRAMS_RENDERER_MODE=remote \
DIAGRAMS_RENDERER_URL=http://127.0.0.1:8001 \
diagrams-mcp-server

其中包含 Docker/Railway 示例：

主要环境变量：

支持的提供商

render_diagram 工具支持 mingrammer/diagrams 库中的所有提供商，包括：

AWS、GCP、Azure、Kubernetes、On-Premise、AlibabaCloud、OCI、OpenStack、DigitalOcean、Elastic、Outscale、Generic 和 Custom 节点。

使用 list_providers() 和 search_nodes(query) 查找可用节点。

许可证

MIT