WireViz MCP Server

WireViz MCP Server

简介

WireViz MCP Server 是一款基于 Model Context Protocol（MCP）标准的服务器，将开源线束设计工具 WireViz 与 AI 助手连接，使 AI 能够辅助完成电子线束的设计、bom 生成和可视化输出。

核心能力

• 概念图生成（concept_to_mermaid）：将自然语言描述的线束概念转换为 Mermaid 流程图，用于设计规划阶段的思路梳理和评审
• Mermaid 渲染（mermaid_to_svg）：将 Mermaid 图渲染为矢量 SVG 图片，方便嵌入文档或分享
• 线束设计生成（harness_to_wireviz）：接收完整的线束设计描述，生成 WireViz YAML 格式规范文件
• BOM 表导出（wireviz_to_bom）：从 WireViz YAML 文件提取元件清单，导出为 TSV 格式的物料清单表格
• PNG 渲染（wireviz_to_png）：将 WireViz YAML 渲染为 PNG 图片，用于快速预览和文档插入

安装配置

方式一：pip 安装

python -m venv .venv
.venv/bin/pip install git+https://github.com/chrisflesher/wireviz-mcp.git

然后在 MCP 配置文件中添加：

{
  "mcpServers": {
    "wireviz-mcp": {
      "command": ".venv/bin/wireviz-mcp-server",
      "args": []
    }
  }
}

方式二：uvx 安装（无需虚拟环境）

{
  "mcpServers": {
    "wireviz-mcp": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/chrisflesher/wireviz-mcp.git",
        "wireviz-mcp-server"
      ]
    }
  }
}

使用步骤

1. 安装并配置服务器：选择上述任一方式完成安装，在 AI 助手的 MCP 配置中添加服务器地址
2. 描述线束需求：向 AI 描述电子设备的连接需求，如"设备A有3根电源线分别连接到设备B的接口1、2、3，使用AWG20规格线缆"
3. 生成设计图：AI 调用 concept_to_mermaid 生成 Mermaid 规划图，你确认后调用 harness_to_wireviz 生成 WireViz YAML 文件
4. 导出物料清单：调用 wireviz_to_bom 导出 TSV 格式 BOM 表，用于采购和生产准备
5. 生成可视化输出：用 wireviz_to_png 或 mermaid_to_svg 导出图片，放入设计文档或需求说明书中

适用场景

• 电子设备研发：在硬件开发早期快速生成线束连接图，减少手工绘图工作量
• IoT 产品设计：设计传感器网络和主控板之间的连接规范，用 AI 辅助梳理复杂拓扑
• 生产文档编制：导出标准 BOM 表和线束图，用于工厂生产和 QC 检验
• 团队协作与评审：用 Mermaid 图分享设计思路，非技术人员也能看懂连接关系

适用人群

• 硬件工程师：负责电子设备内部接线和线束设计的工程师
• IoT 产品经理：需要快速验证硬件连接方案可行性的产品经理
• 嵌入式开发者：需要了解设备间连接关系来编写固件和通信协议的开发者
• 技术文档工程师：编写硬件规格书和设备说明书时需要插入线束示意图

工作原理

WireViz MCP Server 封装了 WireViz 工具链的调用入口，通过 MCP 协议暴露五个工具给 AI 助手。WireViz 本身是一个用 Python 编写的线束设计辅助工具，支持用 YAML 格式描述连接关系并渲染为图片或 SVG。MCP 服务器负责接收 AI 的结构化指令，调用相应的 WireViz 命令行工具，返回结果给 AI 整理呈现。服务器本身以 Python 包形式发布，通过标准输入输出（stdio）方式与 MCP 客户端通信。

官方链接

• GitHub：https://github.com/chrisflesher/wireviz-mcp
• WireViz 官网：https://github.com/formatc1702/WireViz
• PyPI：https://pypi.org/project/wireviz-mcp/