VoltPlan Wiring Diagrams

io.github.YUZU-Hub由 GitHub 账号 YUZU-Hub 发布v0.5.0更新于 Nov 20, 2026

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

发布方自己的服务:Diagram

已验证Streamable HTTP可网页运行开发者工具数据与分析商业与电商

概览

AI 生成的概览

为助手提供 12V/24V/48V 电气系统专业知识:计算线径、保险丝、电池、太阳能与逆变器,并为房车、船只和离网系统生成接线图。

可以做什么
  • 计算每日用电预算、电池组容量与串并联配置、太阳能板功率、充电时间、逆变器功率,以及线径并给出保险丝建议
  • 生成完整接线图(图片或 SVG),并附打开 VoltPlan 编辑器继续编辑的链接
  • 列出元件类型与示例配置,为生成接线图做准备
  • 在 VoltPlan 精选元件目录中按规格查找真实产品,按最接近的额定值排序
  • 为同一系统生成物料清单,包含线缆、保险丝、端子和工具
适用场景
适合在规划或改装房车、厢式车、船只或离网供电系统时使用,希望用一句自然语言提示得到选型计算和接线图,而不必手工推算。
运行要求
可使用托管远程端点,或通过 npx 在本地运行(需 Node.js)。自托管时使用环境变量 VOLTPLAN_API_URL(默认 VOLTPLAN_PB_URL、VOLTPLAN_TELEMETRY 和 PORT。未声明需要账号或 API 密钥。接线图渲染、元件匹配和物料清单需访问 VoltPlan API,因此需要网络。
安装前请注意
接线图渲染、元件匹配和物料清单会把请求发送到 VoltPlan 服务器。购买链接经由 VoltPlan 跳转,VoltPlan 从中获得佣金。除非关闭 VOLTPLAN_TELEMETRY,否则会向 VoltPlan 分析服务发送匿名使用事件(工具名、粗略输入、客户端名称)。目录结果可能与所请求规格有偏差,购买前应核对参数。

安装

在 SourceWeft 中

  1. 打开 控制台中的 VoltPlan Wiring Diagrams,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.YUZU-Hub%2Fwiring-diagram-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "voltplan-wiring-diagrams": {
      "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

Eleven 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 an image (PNG, default) or icon-free SVG, auto-fused and protected, plus a link that opens the system in the VoltPlan editor
list_component_typesComponent reference and example configs for diagram building
find_componentsReal products from VoltPlan's curated catalogue that match a spec (category, system voltage, watts, Ah/Wh, pure sine), closest rating first, with product page and buy links
build_bomShopping list for the same system the diagram takes: components with matching catalogue products, cable per gauge with lengths, fuses, fuse holders, terminals and tools, sized like the diagram

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 shows the schematic as an image: batteries with terminals, MPPT charger, auto-generated shunt, main switch, low-voltage cutoff, and fused load lines in red/black with computed gauges. Below it comes a link that opens the system in the VoltPlan editor with the battery, the solar panel and the first load already placed, to finish, save and turn into a shopping list.

Loads need only power or current, batteries only capacityAh or energyWh; the server derives the rest, and voltages default to the first battery's.

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, catalogue matches (find_components) and shopping lists (build_bom)
VOLTPLAN_PB_URLhttps://base.voltplan.appVoltPlan catalogue (public, read-only) for curated cable and fuse links
VOLTPLAN_TELEMETRYonoff disables the usage events described under Telemetry
PORT3001HTTP server port

Docker

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

Architecture

[Architecture]

Calculations run inside the MCP server and are deterministic. Diagram rendering hits the VoltPlan API and returns a PNG (or SVG) that the AI client shows in the chat, or an interactive viewer in hosts with MCP Apps (see below). find_components and build_bom call VoltPlan's public /api/components/match and /api/diagram/bom endpoints; the shopping list is sized by the same code that renders the diagram. calculate_wire_gauge additionally reads VoltPlan's public catalogue (cached for an hour) to link the recommended cable and fuse to a curated product; without it the links fall back to a store search.

Links and attribution

Buy links go through voltplan.app/api/go with source=mcp, which picks the reader's local Amazon store; VoltPlan earns a commission on purchases (Amazon Associate). Links to voltplan.app pages carry utm_source=mcp.

https://mcp.voltplan.app/mcp-clean serves the same tools without buy links and without pointers to other VoltPlan pages (tool descriptions included). Use it where tool output must not carry promotional content, e.g. Anthropic's connector directory. The diagram's editor link stays, because it opens the generated system for editing. find_components and build_bom return no links at all there: product names, specs, quantities and ratings only. The same holds for the interactive viewer: there it shows a parts list without buy buttons.

Interactive diagram in the chat (MCP Apps)

generate_wiring_diagram declares an MCP Apps view (_meta.ui.resourceUri → ui://wiring-diagram/diagram-viewer-v1.html, spec 2026-01-26). Hosts that support MCP Apps (Claude, ChatGPT, VS Code Copilot, Goose, …) show the diagram as a viewer in the chat instead of a static image:

  • zoom (buttons, Ctrl/⌘ + scroll, pinch, double-click), pan by dragging, fit, full screen where the host offers it;
  • Open in VoltPlan editor (through the host's ui/open-link);
  • Shopping list (Parts list on /mcp-clean): calls build_bom with the same system and shows it as a table below the diagram, with buy buttons on /mcp.

The view gets a light SVG (icons loaded from VoltPlan, the only domain in its CSP resourceDomains) and the shopping list through the tool results' _meta, which the model never sees; the model and hosts without MCP Apps keep getting the PNG and the text. Against a VoltPlan without the ?format=json render mode the viewer shows that PNG instead of the SVG.

The view lives in viewer/ and is bundled into dist/viewer.html by npm run build:viewer (part of npm run build, npm run dev and npm test). Try it locally with the basic-host example of ext-apps: SERVERS='["http://localhost:3001/mcp"]' npx tsx serve.ts.

Telemetry

The server sends anonymous usage events to VoltPlan's cookieless analytics (Umami): connection handshakes and tool calls, with the tool name, a few coarse inputs (system voltage, output format, product category) and the client's product name (e.g. claude-ai, from the MCP clientInfo or the HTTP User-Agent). No prompts, no tool arguments beyond those, no IP-derived identifiers. Events record the endpoint as their page (/mcp or /mcp-clean). Set VOLTPLAN_TELEMETRY=off to disable it.

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,提交 0d303bf

工具

11

generate_wiring_diagram

Generate Wiring Diagram

Generate an electrical wiring diagram for campers, boats, or off-grid setups. Returns the schematic as an image (batteries, chargers, protection components, loads) and a link that opens it in the VoltPlan editor to refine, save and turn into a shopping list. Protection components (shunt, main switch, low-voltage cutoff) are auto-generated when both batteries and loads are provided. Show the user the editor link.

输入参数loadsformatchargersbatteriessystemName必填

find_components

Find Components

Find real products in VoltPlan's curated component catalogue that match a spec, e.g. a 200 Ah 12 V LiFePO4 battery or a 2000 W pure-sine inverter. Results come closest rating first. The catalogue is small and curated, so results may deviate from the requested spec; check the listed specs. Use it after the calculators (calculate_battery_bank, calculate_solar_size, calculate_inverter_size) have sized the part. Returns product pages and buy links for each product; show them to the user.

输入参数limitquerycategory必填pureSinecapacityAhcapacityWhpowerWattssystemVoltage

build_bom

Build Shopping List

Build the shopping list (bill of materials) for the same system generate_wiring_diagram takes: components with matching products from VoltPlan's catalogue, cable per gauge with lengths, fuses, fuse holders, terminals and tools, sized with the same rules as the diagram. Returns buy links for every line and a link that opens the system in the VoltPlan editor; show them to the user.

输入参数loadschargersbatteriessystemName必填

list_component_types

List Component Types

List all available component types and example configurations for building wiring diagrams. Use this to understand what parameters are needed before calling generate_wiring_diagram.

无需输入参数。

calculate_wire_gauge

Cable Cross-Section & Resistance Calculator

Calculate the recommended wire gauge / cable cross-section for a DC circuit. Considers both ampacity (current carrying capacity) and voltage drop to recommend the optimal cable size. Also returns total resistance, power loss, and a fuse recommendation. Supports copper conductors from 0.75 mm² (18 AWG) to 240 mm² (300 MCM).

输入参数powercurrentvoltage必填isRoundTripcableLengthM必填temperatureCelsiusmaxVoltageDropPercent

calculate_power_budget

Power Budget / Energy Audit

Calculate total daily energy consumption from a list of electrical loads. Each load specifies its power draw, how many hours per day it runs, and quantity. Returns total daily energy (Wh and Ah), peak power draw, and average power. This is typically the first step in sizing a battery bank and solar system.

输入参数loads必填systemVoltage必填

calculate_battery_bank

Battery Bank Sizing Calculator

Calculate the recommended battery bank size based on daily energy consumption. Accounts for days of autonomy (how many days without charging) and depth of discharge. Returns required capacity, number of batteries, and wiring configuration.

输入参数systemVoltage必填daysOfAutonomysingleBatteryAh必填dailyConsumptionWh必填singleBatteryVoltage必填depthOfDischargePercent

calculate_solar_size

Solar Panel Sizing Calculator

Calculate the required solar panel wattage to cover daily energy consumption. Accounts for peak sun hours at the location and system efficiency losses (MPPT conversion, wiring, temperature derating). Returns required wattage and common panel configurations.

输入参数peakSunHours必填systemEfficiencydailyConsumptionWh必填

calculate_charging_time

Charging Time Calculator

Estimate how long it takes to charge a battery bank from a given state of charge to a target level. Accounts for the bulk charging phase (constant current, up to ~80% SoC) and the slower absorption phase (tapering current, 80-100% SoC). Works for any charging source: solar, shore power, alternator.

输入参数batteryVoltage必填chargePowerWatts必填batteryCapacityAh必填chargeCurrentAmpstargetStateOfChargePercentcurrentStateOfChargePercent必填

calculate_inverter_size

Inverter Sizing Calculator

Calculate the recommended inverter size for running AC loads from a DC battery system. Accounts for continuous power, startup surge power (motors typically surge 2-3x), and includes a 25% headroom for the continuous rating. Returns the recommended inverter wattage and the DC current draw at system voltage.

输入参数loads必填systemVoltage必填

calculate_battery_config

Battery Configuration Calculator

Determine how to arrange batteries in series and/or parallel to achieve a target voltage and capacity. Returns the number of batteries needed, the wiring configuration (e.g. 2S3P), and step-by-step wiring instructions.

输入参数targetVoltage必填singleBatteryAh必填targetCapacityAh必填singleBatteryVoltage必填

版本历史

3
  1. v0.5.0最新Nov 19, 2026
  2. v0.3.0Oct 29, 2026
  3. v0.2.2Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Diagram 集成