AI导哈

架构图生成服务

基于Python diagrams库的架构图生成服务，支持基础设施、架构图和流程图的代码化生成与验证。

  • by apetta
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 apetta/diagrams-mcp

使用说明

图表MCP服务器

MCP服务器，用于使用Python生成基础设施和架构图作为代码 图表 图书馆。

特性

5图表工具 对于基础设施、架构和流程图：

  • 基础设施图 -15+提供商（AWS、Azure、GCP、K8s、On-Prem、SaaS）
  • 500+节点类型 -计算、数据库、网络、存储、安全
  • 自定义图标 -Web URL（HTTPS）和本地文件
  • 流程图 -24种工艺图形状
  • 验证 -发电前的干运行

高级功能：

  • 多种输出格式（PNG、PDF、JPG、DOT）
  • 无限制嵌套的集群分组
  • 边缘样式（颜色、标签、线条样式）
  • Graphviz属性定制

安装

系统要求：

  • 必须安装Graphviz：
    • macOS： brew install graphviz
    • Ubuntu/Debian： sudo apt-get install graphviz
    • Windows：从下载https://graphviz.org/download/

月中日

克劳德桌面

添加到您的 claude_desktop_config.json:

对于已发布的包：

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

对于当地发展：

{
  "mcpServers": {
    "diagrams:local": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/diagrams-mcp",
        "run",
        "diagrams-mcp"
      ]
    }
  }
}

克劳德代码

快速设置（CLI）：

已发布包：

claude mcp add --transport stdio math -- uvx diagrams-mcp

地方发展：

claude mcp add --transport stdio math -- uvx --from /absolute/path/to/diagrams-mcp diagrams-mcp

团队设置（项目级）：

添加 .mcp.json 到您的项目根目录：

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

验证安装：

claude mcp list

或者检查IDE：查看→ MCP服务器，或使用 /mcp 命令。

试试看

安装后，请尝试以下提示：

  • “使用Route53、ELB、EC2实例和RDS创建AWS三层web应用程序图”
  • “生成具有入口、服务和Pod的Kubernetes微服务架构”
  • “为具有决策点的CI/CD管道构建流程图”
  • “使用我公司徽标URL中的自定义图标创建图表”
  • “显示所有可用的AWS计算节点”

映射到工具： create_diagram, create_diagram_with_custom_icons, create_flowchart, list_available_nodes, validate_diagram_spec

工具参考

所有工具参数和描述都可以在IDE的自动补全中找到。

图表生成（3个工具）

工具 说明
create_diagram 所有供应商的完整基础设施/架构图
create_diagram_with_custom_icons 带有来自URL或本地文件的自定义节点图标的图表
create_flowchart 使用24种流程形状简化流程图创建

发现与验证（2个工具）

工具 说明
list_available_nodes 按提供商、类别或关键字搜索500多个可用节点
validate_diagram_spec 发电前的干运行验证

自定义图标

Web URL图标

  • 仅HTTPS（HTTP被拒绝）
  • 5MB文件大小限制
  • 5秒下载超时
  • 图像格式验证（PNG、JPG）
  • 自动缓存（~/.diagrams_mcp/icon_cache）

本地文件图标

  • 路径验证（文件必须存在）
  • 格式验证
  • 沙盒执行

发展

运行测试

# Run all tests
uv run poe test

发展模式

STDIO模式 （用于Claude Desktop集成）：

uv run diagrams-mcp

HTTP模式 （适用于集装箱部署）：

uv run diagrams-mcp-http --port 8000

许可证

MIT许可证。看 LICENSE 文件以获取详细信息。

贡献

欢迎通过PR投稿！请确保：

  1. 测试通过，如果适用，将添加新的测试
  2. 代码已过梁并格式化
  3. 包括类型提示
  4. 提供清晰、可操作的错误消息

支持

有关问题和疑问，请在GitHub上打开问题。

相关 MCP