{
  "markdown": "# VoltPlan Wiring Diagrams · MCP Server\n\n> **I refit my boat with Claude as the electrician. Here's the MCP that made it possible.**\n\nAn [MCP](https://modelcontextprotocol.io/) 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.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![npm](https://img.shields.io/npm/v/wiring-diagram-mcp.svg)](https://www.npmjs.com/package/wiring-diagram-mcp)\n[![MCP](https://img.shields.io/badge/MCP-compatible-7c3aed.svg)](https://modelcontextprotocol.io/)\n[![Hosted](https://img.shields.io/badge/hosted-mcp.voltplan.app-22c55e.svg)](https://mcp.voltplan.app/mcp)\n\n```json\n{ \"mcpServers\": { \"wiring-diagram\": { \"url\": \"https://mcp.voltplan.app/mcp\" } } }\n```\n\nDrop 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.\n\n---\n\n## Why this exists\n\nBuilt 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.\n\nThe 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.\n\n## What it does\n\nNine tools, all callable by name from any MCP client:\n\n| Tool | What it does |\n|---|---|\n| `calculate_power_budget` | Daily energy draw from a list of loads (Wh, Ah, peak power) |\n| `calculate_battery_bank` | Bank size for given consumption + autonomy + DoD |\n| `calculate_battery_config` | Series/parallel arrangement to hit a target voltage and capacity |\n| `calculate_solar_size` | Panel wattage to recharge daily, accounting for sun hours and losses |\n| `calculate_wire_gauge` | AWG / mm² for current and run length, with fuse recommendation |\n| `calculate_inverter_size` | Inverter wattage for AC loads, with surge headroom and DC current draw |\n| `calculate_charging_time` | Time from X% to Y% SoC, with bulk and absorption phases |\n| `generate_wiring_diagram` | Complete schematic as SVG or PNG, auto-fused and protected |\n| `list_component_types` | Component reference and example configs for diagram building |\n\n## Demo\n\nThree real prompts, three real outputs.\n\n### 1. Size a sailboat house bank\n\n> *\"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.\"*\n\nClaude calls `calculate_power_budget` then `calculate_battery_bank`:\n\n```\nTotal daily energy: 1,870 Wh/day  (155.8 Ah/day at 12V)\nPeak load:           205 W        (17.1 A)\n\nRequired capacity (2 days × 80% DoD):  4,675 Wh / 389.6 Ah\nRecommended bank: 4 × 100 Ah / 12.8 V LiFePO4 in parallel (4P)\nTotal / usable:   400 Ah / 5,120 Wh   →   4,096 Wh usable\n                  ≈ 2.2 days of autonomy\n```\n\n### 2. Pick a gauge for an inverter run\n\n> *\"What gauge wire for a 50A inverter run, 3 meters one-way, 12V, marine environment, max 3% drop?\"*\n\nClaude calls `calculate_wire_gauge`:\n\n```\nRecommended cable:    16 mm² (6 AWG)   — rated 65 A\nVoltage drop:         0.34 V (2.80%)   ✓ within target\nTotal resistance:     6.7 mΩ\nPower lost as heat:   16.8 W\nFuse:                 70 A ANL bolt-down, within 18 cm of battery+\n\nStatus: OK — wire size meets all requirements.\n```\n\n(Ampacity alone would allow 10 mm² / 8 AWG, but voltage drop drives the choice up at this length.)\n\n### 3. Generate a full schematic\n\n> *\"Generate a wiring diagram for: 2 × 100W solar → MPPT → 200 Ah LiFePO4 → BMV-712 monitor → main 12V bus → fridge, lights, USB.\"*\n\nClaude 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.\n\nSee [`examples/`](./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.\n\n## 5-minute setup\n\n### Claude Desktop (hosted — easiest)\n\nEdit `claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"wiring-diagram\": {\n      \"url\": \"https://mcp.voltplan.app/mcp\"\n    }\n  }\n}\n```\n\nRestart Claude. The hammer icon in the chat input means tools are active.\n\n### Claude Desktop (local via npx)\n\n```json\n{\n  \"mcpServers\": {\n    \"wiring-diagram\": {\n      \"command\": \"npx\",\n      \"args\": [\"wiring-diagram-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\n# hosted\nclaude mcp add wiring-diagram --transport http https://mcp.voltplan.app/mcp\n\n# local\nclaude mcp add wiring-diagram -- npx wiring-diagram-mcp\n```\n\n### Cursor\n\nEdit `~/.cursor/mcp.json` (or `.cursor/mcp.json` per-project):\n\n```json\n{\n  \"mcpServers\": {\n    \"wiring-diagram\": {\n      \"url\": \"https://mcp.voltplan.app/mcp\"\n    }\n  }\n}\n```\n\n### Cline (VS Code)\n\nOpen the Cline panel → MCP Servers → Edit MCP Settings, then:\n\n```json\n{\n  \"mcpServers\": {\n    \"wiring-diagram\": {\n      \"url\": \"https://mcp.voltplan.app/mcp\"\n    }\n  }\n}\n```\n\n### Self-hosted HTTP server\n\n```bash\nnpm install\nnpm run build\nnpm run start:http   # listens on http://localhost:3001/mcp\n```\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `VOLTPLAN_API_URL` | `https://voltplan.app` | VoltPlan instance for diagram rendering |\n| `PORT` | `3001` | HTTP server port |\n\n### Docker\n\n```bash\ndocker build -t wiring-diagram-mcp .\ndocker run -p 3001:3001 wiring-diagram-mcp\n```\n\n## Architecture\n\n![Architecture](./docs/architecture.svg)\n\nCalculations 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.\n\n## Examples\n\nWorked scenarios in [`examples/`](./examples):\n\n- [Sailboat refit (30 ft, cruising)](./examples/sailboat-refit.md)\n- [Sprinter van conversion](./examples/sprinter-van.md)\n- [Off-grid cabin](./examples/off-grid-cabin.md)\n- [Day sailer (minimal)](./examples/day-sailer.md)\n- [Live-aboard (heavy loads, AC galley)](./examples/live-aboard.md)\n\n## Roadmap\n\n- AC-side calculations: shore power inlet, breaker panel sizing, isolation transformer\n- More battery chemistries: AGM/Gel sizing curves, lead-carbon\n- Multi-bank topologies: starter + house with combiner / DC-DC charger\n- Wire run optimization: shared trunks, terminal block placement\n\n## Related\n\n- [VoltPlan](https://voltplan.app) — web app for visual electrical system design\n- [VoltPlan Wire Gauge Calculator](https://voltplan.app) — free, no signup\n\n## About\n\nBuilt by Stefan Lange-Hegermann ([yuzuhub.com](https://yuzuhub.com)). Powered by [VoltPlan](https://voltplan.app).\n\nIssues, ideas, and pull requests welcome on [GitHub](https://github.com/YUZU-Hub/wiring-diagram-mcp).\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 7229,
  "sha": "5e74c5c996c79fb6e58640a6041c2670330f120adb2a1d7db7e756ac57a1d004",
  "repo_slug": "yuzu-hub/wiring-diagram-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_yuzu_hub_wiring_diagram_mcp_4d598bc7/readme"
}