io.github.YUZU-Hub/wiring-diagram-mcp

Official9 tools

by YUZU-Hub · TypeScript

VoltPlan Wiring Diagrams

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

Generate electrical wiring diagrams and size components for various voltage systems.

Topics

camperelectricalmcpmcp-servermodel-context-protocoloff-gridwiring-diagram

Captured live from the server via tools/list.

generate_wiring_diagram

Generate an electrical wiring diagram for campers, boats, or off-grid setups. Returns a complete schematic with batteries, chargers, protection components, and loads. Protection components (shunt, main switch, low-voltage cutoff) are auto-generated when both batteries and loads are provided.

Parameters (5)

systemNamestringrequired
Name of the electrical system (e.g. "My Camper Van")
batteriesarray
Batteries in the system
loadsarray
Electrical loads / consumers
chargersarray
Chargers with their power sources
formatstring
Output format: svg (recommended, renders inline) or png (base64-encoded image, may not display in all clients)

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.

No parameters.

calculate_wire_gauge

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).

Parameters (7)

voltagenumberrequired
System voltage in volts (e.g. 12, 24, 48)
currentnumber
Load current in amps. Provide either current or power.
powernumber
Load power in watts. Will be converted to current using the voltage. Provide either current or power.
cableLengthMnumberrequired
One-way cable length in meters
maxVoltageDropPercentnumber
Maximum acceptable voltage drop in percent (default: 3%)
temperatureCelsiusnumber
Ambient temperature in °C (default: 20°C). Affects copper resistance.
isRoundTripboolean
Account for both positive and negative conductor (default: true). Set to false for chassis-ground returns.

calculate_power_budget

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.

Parameters (2)

systemVoltagenumberrequired
System voltage in volts (e.g. 12, 24, 48)
loadsarrayrequired
List of electrical loads to include in the budget

calculate_battery_bank

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.

Parameters (6)

dailyConsumptionWhnumberrequired
Daily energy consumption in watt-hours (from calculate_power_budget)
daysOfAutonomynumber
Days the system should run without any charging (default: 2)
depthOfDischargePercentnumber
Usable percentage of battery capacity. LiFePO4: 80-90%, AGM: 50%, Gel: 50% (default: 80)
systemVoltagenumberrequired
Target system voltage in volts (e.g. 12, 24, 48)
singleBatteryAhnumberrequired
Capacity of a single battery in amp-hours (e.g. 100, 200)
singleBatteryVoltagenumberrequired
Voltage of a single battery (e.g. 12.8 for LiFePO4, 12 for lead-acid)

calculate_solar_size

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.

Parameters (3)

dailyConsumptionWhnumberrequired
Daily energy consumption in watt-hours (from calculate_power_budget)
peakSunHoursnumberrequired
Average daily peak sun hours for the location. Examples: Northern Europe winter 1-2h, summer 4-6h. Southern US 5-6h. Equatorial regions 5-7h.
systemEfficiencynumber
Overall system efficiency factor (default: 0.85). Accounts for MPPT losses, wiring losses, temperature derating, and panel soiling.

calculate_charging_time

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.

Parameters (6)

batteryCapacityAhnumberrequired
Total battery bank capacity in amp-hours
batteryVoltagenumberrequired
Battery bank voltage (e.g. 12, 24, 48)
currentStateOfChargePercentnumberrequired
Current state of charge in percent (e.g. 20 for 20%)
targetStateOfChargePercentnumber
Target state of charge in percent (default: 100)
chargePowerWattsnumberrequired
Charger output power in watts
chargeCurrentAmpsnumber
Maximum charge current in amps (if limited by the charger or battery BMS). If omitted, calculated from power and voltage.

calculate_inverter_size

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.

Parameters (2)

systemVoltagenumberrequired
DC system voltage (e.g. 12, 24, 48)
loadsarrayrequired
List of AC loads that will run through the inverter

calculate_battery_config

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.

Parameters (4)

targetVoltagenumberrequired
Desired system voltage (e.g. 12, 24, 48)
targetCapacityAhnumberrequired
Desired total capacity in amp-hours
singleBatteryVoltagenumberrequired
Nominal voltage of one battery (e.g. 12.8 for LiFePO4, 12 for lead-acid, 3.2 for LiFePO4 cells)
singleBatteryAhnumberrequired
Capacity of one battery in amp-hours

Install

Configuration

Environment variables

VOLTPLAN_API_URL

URL of the VoltPlan API instance

claude_desktop_config.json

{
  "mcpServers": {
    "wiring-diagram-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wiring-diagram-mcp@0.2.2"
      ],
      "env": {
        "VOLTPLAN_API_URL": "<YOUR_VOLTPLAN_API_URL>"
      }
    }
  }
}