Wiring Diagram Mcp By Voltplan

VoltPlan 接线图 · MCP 服务

我把船重新改装了一遍，让 Claude 当电工。这款 MCP 工具让这一切成为可能。

一个 MCP 服务，为 Claude（或任何兼容 MCP 的 AI）提供 12V / 24V / 48V 电气系统领域的专业知识——计算电池组容量、选择线径、推荐保险丝，并生成完整的接线图。适用于船只、露营车、厢式车和离网项目。

{ "mcpServers": { "wiring-diagram": { "url": "https://mcp.voltplan.app/mcp" } } }

将其放入 claude_desktop_config.json，重启 Claude，然后提问：“为一艘 30 英尺帆船规划一个 400 Ah 的锂电池家用电池组，续航 2 天。” 完成。

---

为什么要做这个项目

在荷兰鲁尔蒙德为 Largo（一艘 1996 年的 Maxum）改装时，我做了这个项目。计算总是妨碍实际施工——先计算电池组容量，再算线径，然后选保险丝；只要一项负载发生变化，就得全部重算。所以我把计算交给了 Claude。现在它会计算电池组容量、选择线径并生成接线图。我更愿意自己动手布线。

这些计算正是任何巡航者或厢式车旅行者晚上 11 点在方格纸上都会做的那些计算。这个服务让它们只需一句提示词就能完成。

它能做什么

九种工具，可通过名称从任何 MCP 客户端调用：

工具	功能
calculate_power_budget	根据负载列表计算每日能耗（Wh、Ah、峰值功率）
calculate_battery_bank	根据给定的耗电量、续航时间和 DoD 计算电池组容量
calculate_battery_config	计算串并联方案，以达到目标电压和容量
calculate_solar_size	根据日照时长和损耗，计算满足每日充电需求的面板功率
calculate_wire_gauge	根据电流和线路长度计算 AWG / mm²，并推荐保险丝
calculate_inverter_size	根据交流负载计算逆变器功率，并预留浪涌余量、计算直流电流
calculate_charging_time	计算 SoC 从 X% 充至 Y% 所需时间，包含大电流充电和吸收充电阶段
generate_wiring_diagram	生成完整电路图，可输出图像（默认 PNG）或不含图标的 SVG；自动配置保险丝和保护装置，并提供可在 VoltPlan 编辑器中打开该系统的链接
list_component_types	提供组件参考信息和用于绘制图表的配置示例

演示

三个真实提示词，三个真实输出。

1. 计算帆船家用电池组容量

“为一艘 30 英尺帆船规划一个 400 Ah 的锂电池家用电池组。负载：12V 冰箱全天运行（60W）、LED 航行灯和舱灯（25W，每天 4 小时）、USB 充电器（30W，每天 2 小时）、偶尔用逆变器给笔记本电脑供电（90W，每天 3 小时）。无太阳能供电时续航 2 天，LiFePO4，DoD 为 80%。”

Claude 依次调用 calculate_power_budget 和 calculate_battery_bank：

Total daily energy: 1,870 Wh/day  (155.8 Ah/day at 12V)
Peak load:           205 W        (17.1 A)

Required capacity (2 days × 80% DoD):  4,675 Wh / 389.6 Ah
Recommended bank: 4 × 100 Ah / 12.8 V LiFePO4 in parallel (4P)
Total / usable:   400 Ah / 5,120 Wh   →   4,096 Wh usable
                  ≈ 2.2 days of autonomy

2. 为逆变器线路选择线径

“一条 50A 逆变器线路，单程 3 米，12V，船用环境，最大压降 3%，应该用多粗的线？”

Claude 调用 calculate_wire_gauge：

Recommended cable:    16 mm² (6 AWG)   — rated 65 A
Voltage drop:         0.34 V (2.80%)   ✓ within target
Total resistance:     6.7 mΩ
Power lost as heat:   16.8 W
Fuse:                 70 A ANL bolt-down, within 18 cm of battery+

Status: OK — wire size meets all requirements.

（仅按载流量计算，可使用 10 mm² / 8 AWG；但在这个长度下，电压降要求选择更粗的线。）

3. 生成完整示意图

"生成以下系统的接线图：2 × 100W 太阳能板 → MPPT → 200 Ah LiFePO4 → BMV-712 监测器 → 12V 主母线 → 冰箱、灯、USB。"

Claude 会调用 generate_wiring_diagram，并以图像形式展示示意图：包含带接线端子的电池、MPPT 充电器、自动生成的分流器、主开关、低电压断路器，以及用红色／黑色表示并计算好线径的带保险丝负载线路。下方还会提供一个链接，打开 VoltPlan 编辑器中的系统；其中已放置电池、太阳能板和第一个负载，你可以继续完成、保存并将其转换为购物清单。

负载只需提供 power 或 current，电池只需提供 capacityAh 或 energyWh；服务会推导其余参数，电压默认采用第一个电池的电压。

参见 examples/ 中五个完整示例场景——帆船改装、Sprinter 面包车、离网小屋、日间帆船和船居——每个示例均包含提示词、预期的工具调用和计算结果。

5 分钟快速设置

Claude Desktop（托管版——最简单）

编辑 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "wiring-diagram": {
      "url": "https://mcp.voltplan.app/mcp"
    }
  }
}

重启 Claude。聊天输入框中的锤子图标表示工具已启用。

Claude Desktop（通过 npx 本地运行）

{
  "mcpServers": {
    "wiring-diagram": {
      "command": "npx",
      "args": ["wiring-diagram-mcp"]
    }
  }
}

Claude Code

# hosted
claude mcp add wiring-diagram --transport http https://mcp.voltplan.app/mcp

# local
claude mcp add wiring-diagram -- npx wiring-diagram-mcp

Cursor

编辑 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）：

{
  "mcpServers": {
    "wiring-diagram": {
      "url": "https://mcp.voltplan.app/mcp"
    }
  }
}

Cline（VS Code）

打开 Cline 面板 → MCP Servers → Edit MCP Settings，然后：

{
  "mcpServers": {
    "wiring-diagram": {
      "url": "https://mcp.voltplan.app/mcp"
    }
  }
}

自托管 HTTP 服务

npm install
npm run build
npm run start:http   # listens on http://localhost:3001/mcp

环境变量	默认值	用途
VOLTPLAN_API_URL	https://voltplan.app	用于渲染示意图的 VoltPlan 实例
VOLTPLAN_PB_URL	https://base.voltplan.app	VoltPlan 产品目录（公开、只读），用于精选线缆和保险丝链接
VOLTPLAN_TELEMETRY	开启	设为 off 可停用 遥测 中所述的使用事件
PORT	3001	HTTP 服务端口

Docker

docker build -t wiring-diagram-mcp .
docker run -p 3001:3001 wiring-diagram-mcp

架构

计算在 MCP 服务内运行，结果具有确定性。示意图渲染会调用 VoltPlan API，并返回 PNG（或 SVG），由 AI 客户端在聊天中显示。calculate_wire_gauge 还会读取 VoltPlan 的公开产品目录（缓存一小时），将推荐的线缆和保险丝链接到精选产品；如果没有该目录，链接会退回到商店搜索。

链接与署名

购买链接会通过 voltplan.app/api/go 并附带 source=mcp，由此选择读者所在地区的 Amazon 商店；VoltPlan 会从购买中获得佣金（Amazon 联盟计划）。指向 voltplan.app 页面时，链接会带上 utm_source=mcp。

遥测

服务会向 VoltPlan 的无 Cookie 分析服务（Umami）发送匿名使用事件：连接握手和工具调用，以及工具名称、少量粗略输入（系统电压、输出格式）和客户端产品名称（例如 claude-ai，取自 MCP clientInfo 或 HTTP User-Agent）。不会发送提示词、上述信息以外的工具参数，也不会发送基于 IP 生成的标识符。将 VOLTPLAN_TELEMETRY=off 设为 off 即可停用遥测。

示例

examples/ 中的完整场景：

• 帆船改装（30 ft，巡航）
• Sprinter 面包车改装
• 离网小屋
• 日间帆船（精简版）
• 船居（高负载，交流电厨房）

路线图

• 交流电侧计算：岸电接口、断路器面板规格、隔离变压器
• 更多电池化学体系：AGM／Gel 容量曲线、铅碳电池
• 多组电池拓扑：启动电池 + 生活用电电池组，配合组合器／DC-DC 充电器
• 优化布线走向：共用主干线、接线端子排布局

相关链接

• VoltPlan — 用于可视化设计电气系统的 Web 应用
• VoltPlan 线规计算器 — 免费使用，无需注册

关于

由 Stefan Lange-Hegermann (yuzuhub.com) 构建。由 VoltPlan 提供支持。

欢迎通过 GitHub 提交问题、想法和拉取请求。

许可证

MIT — 详见 LICENSE。