プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

VoltPlan Wiring Diagrams

作者:YUZU-Hubバージョン 0.5.0i★ 0iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.YUZU-Hub/wiring-diagram-mcp

インストール方法

できること

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

作者による原文

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー キー不要
  • カテゴリ デザイン・画像・音声

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

作者:pbakaus★ 113,0421 個の skill

Skill · 手順書

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

作者:cathrynlavery★ 68,2961 個の skill

Skill · 手順書

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

作者:zarazhangrui★ 32,5791 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

VoltPlan Wiring Diagrams をインストールして。https://mcp.popnx.com/i/yuzu-hub-wiring-diagram-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.voltplan.app)を通ります · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前VoltPlan Wiring Diagrams
    Remote MCP server URL · アドレスhttps://mcp.voltplan.app/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsVoltPlan Wiring Diagrams

  4. 試してみる

    VoltPlan Wiring Diagrams を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が VoltPlan Wiring Diagrams を使っていると言うか、回答に VoltPlan Wiring Diagrams のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前VoltPlan Wiring Diagrams
    Connection · アドレスhttps://mcp.voltplan.app/mcp
  3. チャットで VoltPlan Wiring Diagrams を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から VoltPlan Wiring Diagrams を選びます

  4. 試してみる

    VoltPlan Wiring Diagrams を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が VoltPlan Wiring Diagrams を使っていると言うか、回答に VoltPlan Wiring Diagrams のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user wiring-diagram https://mcp.voltplan.app/mcp
  3. Claude Code で /mcp と入力

    VoltPlan Wiring Diagrams が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    VoltPlan Wiring Diagrams を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が VoltPlan Wiring Diagrams を使っていると言うか、回答に VoltPlan Wiring Diagrams のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    VoltPlan Wiring Diagrams を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が VoltPlan Wiring Diagrams を使っていると言うか、回答に VoltPlan Wiring Diagrams のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    VoltPlan Wiring Diagrams を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が VoltPlan Wiring Diagrams を使っていると言うか、回答に VoltPlan Wiring Diagrams のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.voltplan.app/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?VoltPlan Wiring Diagrams を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user wiring-diagram https://mcp.voltplan.app/mcp

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "wiring-diagram": {
      "type": "http",
      "url": "https://mcp.voltplan.app/mcp"
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user wiring-diagram -- npx -y wiring-diagram-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "wiring-diagram": {
      "command": "npx",
      "args": [
        "-y",
        "wiring-diagram-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "wiring-diagram": {
      "command": "npx",
      "args": [
        "-y",
        "wiring-diagram-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "wiring-diagram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wiring-diagram-mcp"
      ]
    }
  }
}

自分で入力する値

  • VOLTPLAN_API_URL env
    VoltPlan API インスタンスの URL
    英語の原文を見るURL of the VoltPlan API instance

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
74/週
接続方法
パソコンでもクラウドでも
最新バージョンi
0.5.0
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
最終確認
2026年11月17日
作者
YUZU-Hub
パッケージ
npm: wiring-diagram-mcp
ウェブサイト
voltplan.app
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月17日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • 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

  • 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

    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

  • 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 bat

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

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

  • 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

  • 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 curr

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

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント YUZU-Hub で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    270ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    9件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/yuzu-hub-wiring-diagram-mcp.svg)](https://mcp.popnx.com/en/servers/yuzu-hub-wiring-diagram-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

デザイン・画像・音声のほかのサーバーとの比較i

  • このカテゴリのほかの3322件のうち0%よりスターが多い
  • このカテゴリのほかの3322件のうち96%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3322件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

VoltPlan Wiring Diagramsは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.5.0)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

作者:heygen-com広く使われている★ 8.7万 リポジトリ全体のスター一昨日更新

クラウドで動く✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

作者:pascalorg広く使われている↓ 1037/週★ 2.6万 リポジトリ全体のスター一昨日更新

パソコンでもクラウドでも✓ 提供元 · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

作者:jgraph広く使われている★ 58603 日前更新

クラウドで動く✓ 提供元 · draw.ioPopNx チームが実際に試用

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

作者:figma広く使われている★ 221313 か月前更新

クラウドで動く✓ 提供元 · mcp.figma.com
似たものと比べる
これ
VoltPlan Wiring Diagrams
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえはいいいえ
基本チェック5/54/45/54/44/44/4
ライセンスMITApache-2.0MITApache-2.0–MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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.

{ "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 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. 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 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.

(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):

{

"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)
{

"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

Edit ~/.cursor/mcp.json (or .cursor/mcp.json per-project):

{

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

Cline (VS Code)

Open the Cline panel → MCP Servers → Edit MCP Settings, then:

{

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

Self-hosted HTTP server
npm install

npm run build npm 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
docker build -t wiring-diagram-mcp .

docker run -p 3001:3001 wiring-diagram-mcp

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.