VoltPlan Wiring Diagrams

io.github.YUZU-Hubv0.2.2更新於 Oct 9, 2026

Generate 12V/24V/48V wiring diagrams and size wires, fuses, batteries, solar, and inverters.

已驗證Streamable HTTP可網頁執行Other

概覽

AI 產生的概覽

為船隻、廂型車與離網用電系統計算 12V/24V/48V 電氣配置並產生配線圖。

功能
提供九個工具，涵蓋用電預算、電池組容量與串並聯配置、太陽能板功率、線徑與保險絲選用、逆變器功率以及充電時間估算。繪圖工具可輸出含保險絲負載線路與計算線徑的完整配線圖（SVG 或 PNG），另有元件類型參考工具。計算在伺服器本機完成，繪圖則呼叫 VoltPlan API。
適用情境
適合規劃或改裝直流電氣系統時使用，例如帆船、露營車、廂型車或離網小屋，用一句自然語言提示即可完成電池組、線徑、保險絲與逆變器的計算，也方便產出可供檢視或分享的配線圖。
執行需求
可作為遠端託管端點使用，也可作為本機 npm 套件執行（npx wiring-diagram-mcp），需要 Node.js。自行架設時以環境變數 VOLTPLAN_API_URL（預設 VoltPlan 實例，並以 PORT 設定 HTTP 埠。未宣告需要身分驗證。
安裝前請注意
繪圖時會把系統描述傳送到 VoltPlan API，若不自行架設，設計細節會離開本機。輸出屬於工程參考而非經認證的電氣設計，施工前請依適用標準核對線徑、保險絲與保護配置。不要求任何憑證或付款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 VoltPlan Wiring Diagrams，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

VoltPlan Wiring Diagrams · MCP Server

I refit my boat with Claude as the electrician. Here's the MCP that made it possible.

An MCP server that gives Claude (or any MCP-compatible AI) domain expertise in 12V / 24V / 48V electrical systems — sizing the bank, picking the wire gauge, recommending the fuse, and generating a complete wiring diagram. For boats, campers, vans, and off-grid builds.

[License: MIT] [npm] [MCP] [Hosted]

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

Drop that into your claude_desktop_config.json, restart Claude, ask: "Plan a 400 Ah lithium house bank for a 30 ft sailboat with 2 days of autonomy." Done.

Why this exists

Built while refitting Largo, a 1996 Maxum, in Roermond. The math kept getting in the way of the work — sizing the bank, then the gauge, then the fuse, then redoing all of it after one load changed. So I gave Claude the math. Now it sizes the bank, picks the gauge, and generates the diagram. I'd rather just do the cabling.

The calculations are the same ones any cruiser or vanlifer ends up doing on graph paper at 11pm. This server makes them a one-sentence prompt.

What it does

Nine tools, all callable by name from any MCP client:

ToolWhat it does
calculate_power_budgetDaily energy draw from a list of loads (Wh, Ah, peak power)
calculate_battery_bankBank size for given consumption + autonomy + DoD
calculate_battery_configSeries/parallel arrangement to hit a target voltage and capacity
calculate_solar_sizePanel wattage to recharge daily, accounting for sun hours and losses
calculate_wire_gaugeAWG / mm² for current and run length, with fuse recommendation
calculate_inverter_sizeInverter wattage for AC loads, with surge headroom and DC current draw
calculate_charging_timeTime from X% to Y% SoC, with bulk and absorption phases
generate_wiring_diagramComplete schematic as SVG or PNG, auto-fused and protected
list_component_typesComponent reference and example configs for diagram building

Demo

Three real prompts, three real outputs.

1. Size a sailboat house bank

"Plan a 400 Ah lithium house bank for a 30 ft sailboat. Loads: 12V fridge 24/7 (60W), LED nav and cabin lights (25W, 4h/day), USB chargers (30W, 2h/day), occasional inverter for a laptop (90W, 3h/day). 2 days of autonomy without solar, LiFePO4 with 80% DoD."

Claude calls calculate_power_budget then 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 AhRecommended 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. Pick a gauge for an inverter run

"What gauge wire for a 50A inverter run, 3 meters one-way, 12V, marine environment, max 3% drop?"

Claude calls calculate_wire_gauge:

Recommended cable:    16 mm² (6 AWG)   — rated 65 AVoltage drop:         0.34 V (2.80%)   ✓ within targetTotal resistance:     6.7 mΩPower lost as heat:   16.8 WFuse:                 70 A ANL bolt-down, within 18 cm of battery+
Status: OK — wire size meets all requirements.

(Ampacity alone would allow 10 mm² / 8 AWG, but voltage drop drives the choice up at this length.)

3. Generate a full schematic

"Generate a wiring diagram for: 2 × 100W solar → MPPT → 200 Ah LiFePO4 → BMV-712 monitor → main 12V bus → fridge, lights, USB."

Claude calls generate_wiring_diagram and returns an SVG: batteries with terminals, MPPT charger, auto-generated shunt, main switch, low-voltage cutoff, and fused load lines in red/black with computed gauges.

See examples/ for five fully-worked scenarios — sailboat refit, Sprinter van, off-grid cabin, day sailer, live-aboard — each with the prompt, the expected tool calls, and the resulting numbers.

5-minute setup

Claude Desktop (hosted — easiest)

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

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

Restart Claude. The hammer icon in the chat input means tools are active.

Claude Desktop (local via npx)

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

Claude Code

bash
# hostedclaude mcp add wiring-diagram --transport http https://mcp.voltplan.app/mcp
# localclaude mcp add wiring-diagram -- npx wiring-diagram-mcp

Cursor

Edit ~/.cursor/mcp.json (or .cursor/mcp.json per-project):

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

Cline (VS Code)

Open the Cline panel → MCP Servers → Edit MCP Settings, then:

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

Self-hosted HTTP server

bash
npm installnpm run buildnpm run start:http   # listens on http://localhost:3001/mcp
Env varDefaultPurpose
VOLTPLAN_API_URLhttps://voltplan.appVoltPlan instance for diagram rendering
PORT3001HTTP server port

Docker

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

Architecture

[Architecture]

Calculations run locally inside the MCP server (deterministic, no network). Diagram rendering hits the VoltPlan API and returns an SVG or PNG that the AI client embeds in the chat.

Examples

Worked scenarios in examples/:

Roadmap

  • AC-side calculations: shore power inlet, breaker panel sizing, isolation transformer
  • More battery chemistries: AGM/Gel sizing curves, lead-carbon
  • Multi-bank topologies: starter + house with combiner / DC-DC charger
  • Wire run optimization: shared trunks, terminal block placement

Related

About

Built by Stefan Lange-Hegermann (yuzuhub.com). Powered by VoltPlan.

Issues, ideas, and pull requests welcome on GitHub.

License

MIT — see LICENSE.

來源：README.md，提交 96287f6

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026