wiring-diagram-mcp

Gere diagramas de fiação e calculadoras elétricas para campers, barcos e sistemas off-grid.

Documentação

Servidor MCP de Diagramas Elétricos VoltPlan

Reformei meu barco com o Claude como eletricista. Aqui está o MCP que tornou isso possível.

Um servidor MCP que dá ao Claude (ou a qualquer IA compatível com MCP) conhecimento especializado em sistemas elétricos de 12V / 24V / 48V — dimensionando o banco de baterias, escolhendo a bitola do fio, recomendando o fusível e gerando um diagrama elétrico completo. Para barcos, trailers, vans e projetos off-grid.

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

Adicione isso ao seu claude_desktop_config.json, reinicie o Claude e pergunte: "Planeje um banco de baterias de lítio de 400 Ah para um veleiro de 30 pés com 2 dias de autonomia." Pronto.

Por que isso existe

Construído durante a reforma do Largo, um Maxum de 1996, em Roermond. A matemática ficava no caminho do trabalho — dimensionar o banco, depois a bitola, depois o fusível, e refazer tudo depois que uma carga mudava. Então dei a matemática ao Claude. Agora ele dimensiona o banco, escolhe a bitola e gera o diagrama. Eu prefiro apenas fazer a fiação.

Os cálculos são os mesmos que qualquer velejador ou morador de van acaba fazendo em papel quadriculado às 23h. Este servidor transforma isso em um prompt de uma frase.

O que ele faz

Nove ferramentas, todas acionáveis pelo nome a partir de qualquer cliente MCP:

Ferramenta	O que faz
`calculate_power_budget`	Consumo diário de energia a partir de uma lista de cargas (Wh, Ah, potência de pico)
`calculate_battery_bank`	Tamanho do banco para consumo + autonomia + profundidade de descarga
`calculate_battery_config`	Arranjo série/paralelo para atingir tensão e capacidade alvo
`calculate_solar_size`	Potência do painel para recarga diária, considerando horas de sol e perdas
`calculate_wire_gauge`	AWG / mm² para corrente e comprimento do cabo, com recomendação de fusível
`calculate_inverter_size`	Potência do inversor para cargas CA, com margem de pico e consumo de corrente CC
`calculate_charging_time`	Tempo de X% a Y% de estado de carga, com fases de carga e absorção
`generate_wiring_diagram`	Esquema completo em SVG ou PNG, com fusíveis e proteções automáticos
`list_component_types`	Referência de componentes e configurações de exemplo para montagem de diagramas

Demonstração

Três prompts reais, três resultados reais.

1. Dimensionar o banco de baterias de um veleiro

"Planeje um banco de baterias de lítio de 400 Ah para um veleiro de 30 pés. Cargas: geladeira 12V 24/7 (60W), luzes de navegação e cabine LED (25W, 4h/dia), carregadores USB (30W, 2h/dia), inversor ocasional para laptop (90W, 3h/dia). 2 dias de autonomia sem energia solar, LiFePO4 com 80% de profundidade de descarga."

O Claude chama calculate_power_budget e depois 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. Escolher a bitola para um cabo de inversor

"Qual bitola de fio para um cabo de inversor de 50A, 3 metros de percurso simples, 12V, ambiente marinho, queda máxima de 3%?"

O Claude chama 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.

(A ampacidade sozinha permitiria 10 mm² / 8 AWG, mas a queda de tensão eleva a escolha nesse comprimento.)

3. Gerar um esquema completo

"Gere um diagrama elétrico para: 2 × 100W solar → MPPT → 200 Ah LiFePO4 → monitor BMV-712 → barramento principal 12V → geladeira, luzes, USB."

O Claude chama generate_wiring_diagram e retorna um SVG: baterias com terminais, carregador MPPT, shunt gerado automaticamente, chave principal, corte de baixa tensão e linhas de carga com fusíveis em vermelho/preto com bitolas calculadas.

Veja examples/ para cinco cenários totalmente trabalhados — reforma de veleiro, van Sprinter, cabana off-grid, barco de passeio, moradia a bordo — cada um com o prompt, as chamadas de ferramentas esperadas e os números resultantes.

Configuração em 5 minutos

Claude Desktop (hospedado — mais fácil)

Edite claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

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

Reinicie o Claude. O ícone de martelo na entrada do chat indica que as ferramentas estão ativas.

Claude Desktop (local via 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

Edite ~/.cursor/mcp.json (ou .cursor/mcp.json por projeto):

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

Cline (VS Code)

Abra o painel do Cline → Servidores MCP → Editar Configurações MCP e então:

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

Servidor HTTP auto-hospedado

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

Variável de ambiente	Padrão	Finalidade
`VOLTPLAN_API_URL`	`https://voltplan.app`	Instância VoltPlan para renderização de diagramas
`PORT`	`3001`	Porta do servidor HTTP

Docker

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

Arquitetura

Architecture

Os cálculos são executados localmente dentro do servidor MCP (determinísticos, sem rede). A renderização de diagramas acessa a API do VoltPlan e retorna um SVG ou PNG que o cliente de IA incorpora no chat.

Exemplos

Cenários trabalhados em examples/:

Roteiro

Cálculos do lado CA: entrada de energia de terra, dimensionamento do painel de disjuntores, transformador de isolamento
Mais químicas de bateria: curvas de dimensionamento AGM/Gel, chumbo-carbono
Topologias de múltiplos bancos: partida + casa com combinador / carregador CC-CC
Otimização de percursos de fiação: troncos compartilhados, posicionamento de bornes

Relacionados

VoltPlan — aplicativo web para design visual de sistemas elétricos
Calculadora de Bitola de Fio VoltPlan — gratuita, sem cadastro

Sobre

Construído por Stefan Lange-Hegermann (yuzuhub.com). Desenvolvido com VoltPlan.

Problemas, ideias e pull requests são bem-vindos no GitHub.

Licença

MIT — veja LICENSE.