mcp/aws-diagram

AWS Diagram MCP Server 镜像文档

镜像概述和主要用途

这是一个基于Python diagrams包DSL的MCP服务器，用于无缝创建各类图表。它支持通过Python代码生成AWS架构图、序列图、流程图、类图等多种图表类型，适用于需要以代码方式可视化系统架构和流程的场景。

核心功能和特性

可用工具 (3)

工具详情

工具：generate_diagram

功能描述

使用diagrams包从Python代码生成图表。该工具接受使用diagrams包DSL编写的Python代码字符串，生成PNG格式图表（执行时设置show=False以防止自动显示）。

使用说明

1. 首先使用get_diagram_examples了解语法和功能
2. 使用list_icons发现所有可用图标，必须严格使用列表中的图标名称（区分大小写）
3. 按照Python diagrams示例编写图表代码，无需导入额外图标或包（运行时已导入所有必要组件）
4. 将代码提交给该工具生成图表
5. 工具返回生成的PNG文件路径
6. 对于复杂图表，建议使用Cluster组织组件
7. 图表应从左侧的用户或终端设备开始，数据流向右侧

支持的图表类型

• AWS架构图
• 序列图
• 流程图
• 类图
• Kubernetes架构图
• 本地部署图
• 带自定义节点的自定义图表

参数说明

返回值

包含生成图表路径和状态信息的字典。

工具：get_diagram_examples

功能描述

获取不同类型图表的示例代码。该工具提供多种图表类型的即用型示例代码，帮助用户理解diagrams包的语法和功能，作为创建自定义图表的模板。

示例类别

• aws：AWS云架构图（基础服务、分组工作节点、集群化Web服务、Bedrock等）
• sequence：流程和交互流程图
• flow：决策树和工作流图
• class：对象关系和继承图
• k8s：Kubernetes架构图
• onprem：本地基础设施图
• custom：带自定义图标的自定义图表
• all：所有类别的可用示例

每个示例展示diagrams包的不同功能：组件连接、Cluster分组、Edge样式设置、布局方向、多组件实例、自定义图标等。

参数说明

返回值

按示例名称组织的、请求图表类型的示例代码字典。

工具：list_icons

功能描述

列出diagrams包中的可用图标，支持可选过滤。该工具动态检查diagrams包，获取可用于图表的提供商、服务和图标信息。

使用说明

1. 不带过滤器调用以获取所有可用提供商列表
2. 使用provider_filter调用以获取该提供商的所有服务和图标
3. 同时使用provider_filter和service_filter调用以获取特定服务的图标

示例工作流

• 第一次调用：list_icons() → 返回所有可用提供商
• 第二次调用：list_icons(provider_filter="aws") → 返回所有AWS服务和图标
• 第三次调用：list_icons(provider_filter="aws", service_filter="compute") → 返回AWS计算服务图标

参数说明

返回值

按层级组织的可用提供商、服务和图标的字典。

使用场景和适用范围

适用于需要通过代码生成可视化图表的开发者、系统架构师和技术文档编写者，具体场景包括：

• 创建AWS云架构图以展示服务部署关系
• 生成系统交互序列图说明组件通信流程
• 绘制工作流程图文档化业务或技术流程
• 设计类图展示对象关系和继承结构
• 生成Kubernetes集群架构图说明容器部署方案

使用方法和配置说明

MCP服务器配置示例

json
{
  "mcpServers": {
    "aws-diagram": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/aws-diagram"
      ]
    }
  }
}

相关链接

• 什么是MCP服务器？
• https://hub.docker.com/repository/docker/mcp/aws-diagram
• https://github.com/awslabs/mcp