wiring-diagram-mcp

Genera diagramas de cableado y calculadoras eléctricas para casas rodantes, barcos y configuraciones fuera de la red eléctrica.

GitHub

Documentación

VoltPlan Wiring Diagrams · Servidor MCP

Reacondicioné mi barco con Claude como electricista. Aquí está el MCP que lo hizo posible.

Un servidor MCP que le da a Claude (o a cualquier IA compatible con MCP) experiencia en sistemas eléctricos de 12V / 24V / 48V: dimensionar el banco de baterías, elegir el calibre del cable, recomendar el fusible y generar un diagrama de cableado completo. Para barcos, casas rodantes, furgonetas y construcciones fuera de la red.

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

Pégalo en tu claude_desktop_config.json, reinicia Claude, pregunta: "Planifica un banco de baterías de litio de 400 Ah para un velero de 30 pies con 2 días de autonomía." Listo.

Por qué existe esto

Construido mientras reacondicionaba el Largo, un Maxum de 1996, en Roermond. Las matemáticas se interponían constantemente en el trabajo: dimensionar el banco, luego el calibre, luego el fusible, y rehacer todo después de que cambiara una carga. Así que le di las matemáticas a Claude. Ahora dimensiona el banco, elige el calibre y genera el diagrama. Prefiero simplemente hacer el cableado.

Los cálculos son los mismos que cualquier navegante o habitante de furgoneta termina haciendo en papel cuadriculado a las 11 de la noche. Este servidor los convierte en un prompt de una sola frase.

Qué hace

Nueve herramientas, todas invocables por nombre desde cualquier cliente MCP:

Herramienta	Qué hace
`calculate_power_budget`	Consumo diario de energía a partir de una lista de cargas (Wh, Ah, potencia máxima)
`calculate_battery_bank`	Tamaño del banco para consumo + autonomía + profundidad de descarga
`calculate_battery_config`	Disposición serie/paralelo para alcanzar un voltaje y capacidad objetivo
`calculate_solar_size`	Vataje del panel para recargar diariamente, considerando horas de sol y pérdidas
`calculate_wire_gauge`	AWG / mm² para corriente y longitud de recorrido, con recomendación de fusible
`calculate_inverter_size`	Vataje del inversor para cargas de CA, con margen de sobrecarga y consumo de corriente CC
`calculate_charging_time`	Tiempo de X% a Y% de estado de carga, con fases de carga masiva y absorción
`generate_wiring_diagram`	Esquema completo como SVG o PNG, con fusibles y protección automáticos
`list_component_types`	Referencia de componentes y configuraciones de ejemplo para construir diagramas

Demostración

Tres prompts reales, tres resultados reales.

1. Dimensionar un banco de baterías para velero

"Planifica un banco de baterías de litio de 400 Ah para un velero de 30 pies. Cargas: nevera de 12V 24/7 (60W), luces LED de navegación y cabina (25W, 4h/día), cargadores USB (30W, 2h/día), inversor ocasional para portátil (90W, 3h/día). 2 días de autonomía sin solar, LiFePO4 con 80% de profundidad de descarga."

Claude llama a calculate_power_budget y luego a 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. Elegir un calibre para un recorrido de inversor

"¿Qué calibre de cable para un recorrido de inversor de 50A, 3 metros de ida, 12V, entorno marino, caída máxima del 3%?"

Claude llama a 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.

(La ampacidad por sí sola permitiría 10 mm² / 8 AWG, pero la caída de voltaje eleva la elección a esta longitud.)

3. Generar un esquema completo

"Genera un diagrama de cableado para: 2 × 100W solar → MPPT → 200 Ah LiFePO4 → monitor BMV-712 → bus principal de 12V → nevera, luces, USB."

Claude llama a generate_wiring_diagram y devuelve un SVG: baterías con terminales, cargador MPPT, shunt generado automáticamente, interruptor principal, corte de bajo voltaje y líneas de carga con fusible en rojo/negro con calibres calculados.

Consulta examples/ para cinco escenarios completamente desarrollados: reacondicionamiento de velero, furgoneta Sprinter, cabaña fuera de la red, velero de día y vivienda a bordo, cada uno con el prompt, las llamadas a herramientas esperadas y los números resultantes.

Configuración en 5 minutos

Claude Desktop (alojado — el más fácil)

Edita claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

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

Reinicia Claude. El ícono de martillo en la entrada de chat significa que las herramientas están activas.

Claude Desktop (local vía 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

Edita ~/.cursor/mcp.json (o .cursor/mcp.json por proyecto):

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

Cline (VS Code)

Abre el panel de Cline → Servidores MCP → Editar configuración de MCP, luego:

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

Servidor HTTP autohospedado

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

Variable de entorno	Predeterminado	Propósito
`VOLTPLAN_API_URL`	`https://voltplan.app`	Instancia de VoltPlan para renderizado de diagramas
`PORT`	`3001`	Puerto del servidor HTTP

Docker

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

Arquitectura

Architecture

Los cálculos se ejecutan localmente dentro del servidor MCP (deterministas, sin red). El renderizado de diagramas accede a la API de VoltPlan y devuelve un SVG o PNG que el cliente de IA incrusta en el chat.

Ejemplos

Escenarios desarrollados en examples/:

Hoja de ruta

Cálculos del lado de CA: entrada de corriente de puerto, dimensionamiento del panel de disyuntores, transformador de aislamiento
Más químicas de batería: curvas de dimensionamiento AGM/Gel, plomo-carbono
Topologías de múltiples bancos: arranque + casa con combinador / cargador CC-CC
Optimización de recorridos de cable: troncales compartidas, colocación de bloques de terminales

Relacionados

VoltPlan — aplicación web para diseño visual de sistemas eléctricos
Calculadora de calibre de cable de VoltPlan — gratuita, sin registro

Acerca de

Construido por Stefan Lange-Hegermann (yuzuhub.com). Impulsado por VoltPlan.

Problemas, ideas y solicitudes de extracción bienvenidas en GitHub.

Licencia

MIT — consulta LICENCIA.