Wiring Diagram Mcp By Voltplan

VoltPlan Wiring Diagrams · MCP サーバー

Claude を電装技師として、ボートを改装しました。それを可能にした MCP です。

Claude（または MCP 互換の AI）に、12V／24V／48V 電気システムに関する専門知識を提供する MCP サーバーです。バッテリーバンクの容量、電線の太さ、推奨ヒューズを選定し、配線図一式を生成します。ボート、キャンピングカー、バン、オフグリッドの電気設備に対応しています。

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

これを claude_desktop_config.json に貼り付けて Claude を再起動し、「30 ft のヨットで、2 日間自立できる 400 Ah のリチウムハウスバンクを計画して」と尋ねてください。これで完了です。

---

開発の背景

Roermond で 1996 年製の Maxum、「Largo」を改装しているときに作りました。計算に手間取って作業が進まなくなっていました。バッテリーバンクの容量を決め、次に電線の太さを決め、さらにヒューズを決めたあと、負荷が一つ変わるたびにすべてをやり直していました。そこで Claude に計算を任せることにしました。今ではバッテリーバンクの容量を決め、電線の太さを選び、配線図を生成してくれます。私は配線作業に専念したいのです。

計算内容は、クルーザーやバンライファーなら誰でも、夜の 11 時に方眼紙の上で行うことになるものと同じです。このサーバーを使えば、ひと言のプロンプトで済みます。

できること

9 つのツールを、任意の MCP クライアントから名前で呼び出せます。

ツール	機能
calculate_power_budget	負荷一覧から1日の消費エネルギーを計算します（Wh、Ah、ピーク電力）
calculate_battery_bank	消費量、自立日数、DoD に基づいてバッテリーバンクの容量を計算します
calculate_battery_config	目標電圧と容量を満たす直列／並列構成を計算します
calculate_solar_size	日照時間と損失を考慮して、1日の消費分を充電するためのパネル出力を計算します
calculate_wire_gauge	電流と配線距離から AWG／mm² を算出し、ヒューズも推奨します
calculate_inverter_size	サージ余裕と DC 電流消費量を考慮して、AC 負荷に必要なインバーター出力を計算します
calculate_charging_time	バルク充電と吸収充電の段階を考慮して、SoC の X％から Y％までの充電時間を計算します
generate_wiring_diagram	完全な回路図を画像（デフォルトは PNG）またはアイコンなしの SVG で生成します。ヒューズと保護装置を自動で追加し、VoltPlan エディターでシステムを開くリンクも生成します
list_component_types	図の作成に使えるコンポーネントのリファレンスと設定例を表示します

デモ

実際のプロンプト 3 件と、その出力 3 件です。

1. ヨットのハウスバンクの容量を決める

「30 ft のヨット用に 400 Ah のリチウムハウスバンクを計画してください。負荷：12V 冷蔵庫を24時間稼働（60W）、LED の航海灯とキャビンライト（25W、1日4時間）、USB 充電器（30W、1日2時間）、ノートパソコン用インバーターをときどき使用（90W、1日3時間）。太陽光発電なしで2日間自立。LiFePO4、DoD 80％。」

Claude は calculate_power_budget を呼び出し、続いて 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. インバーター配線の電線の太さを選ぶ

「インバーターへの 50A の配線で、片道3メートル、12V、船舶環境、最大電圧降下3％の場合、電線は何ゲージがよいですか？」

Claude は 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.

（許容電流だけを見れば 10 mm²／8 AWG で足りますが、この長さでは電圧降下を考慮すると、より太い電線が必要になります。）

3. 完全な回路図を生成する

「次の配線図を生成してください：100W ソーラーパネル × 2 → MPPT → 200 Ah LiFePO4 → BMV-712 モニター → メイン 12V バス → 冷蔵庫、照明、USB。」

Claude は generate_wiring_diagram を呼び出し、回路図を画像で表示します。端子付きバッテリー、MPPT 充電器、自動生成されたシャント、メインスイッチ、低電圧カットオフ、計算されたゲージを示す赤／黒のヒューズ付き負荷線が含まれます。その下には、バッテリー、ソーラーパネル、最初の負荷がすでに配置された状態でシステムを VoltPlan エディターで開くリンクが表示されます。そこから仕上げ、保存し、買い物リストに変換できます。

負荷には power または current のみ、バッテリーには capacityAh または energyWh のみが必要です。残りはサーバーが算出し、電圧は最初のバッテリーの値がデフォルトになります。

5 つの詳細なシナリオ（ヨットの改装、Sprinter バン、オフグリッド小屋、デイセーラー、船上居住）については、examples/ をご覧ください。それぞれにプロンプト、想定されるツール呼び出し、算出結果が記載されています。

5 分でセットアップ

Claude Desktop（ホスト型 — 最も簡単）

claude_desktop_config.json を編集します（Settings → Developer → Edit Config）。

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

Claude を再起動します。チャット入力欄のハンマーアイコンが表示されていれば、ツールが有効です。

Claude Desktop（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

~/.cursor/mcp.json（またはプロジェクトごとの .cursor/mcp.json）を編集します。

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

Cline（VS Code）

Cline パネルを開き → MCP Servers → Edit MCP Settings を選択し、次の内容を設定します。

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

セルフホスト HTTP サーバー

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

環境変数	デフォルト	用途
VOLTPLAN_API_URL	https://voltplan.app	回路図のレンダリングに使用する VoltPlan インスタンス
VOLTPLAN_PB_URL	https://base.voltplan.app	厳選されたケーブルとヒューズへのリンクに使用する VoltPlan カタログ（公開、読み取り専用）
VOLTPLAN_TELEMETRY	on	off にすると、テレメトリーに記載されている利用イベントの送信を無効にします
PORT	3001	HTTP サーバーのポート

Docker

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

アーキテクチャ

計算は MCP サーバー内で実行され、結果は決定的です。回路図のレンダリングでは VoltPlan API にアクセスし、AI クライアントがチャット内で表示する PNG（または SVG）を返します。calculate_wire_gauge はさらに VoltPlan の公開カタログ（1 時間キャッシュ）を読み込み、推奨ケーブルとヒューズを厳選された製品にリンクします。これを利用できない場合、リンクはストアの検索結果に切り替わります。

リンクと帰属表示

購入リンクは source=mcp を指定して voltplan.app/api/go を経由します。これにより、読者の地域に対応した Amazon ストアが選択されます。VoltPlan は購入に対するコミッションを受け取ります（Amazon アソシエイト）。voltplan.app のページへのリンクには utm_source=mcp が付加されます。

テレメトリー

サーバーは、Cookie を使用しない VoltPlan のアナリティクス（Umami）に匿名の利用イベントを送信します。送信されるのは、接続ハンドシェイクとツール呼び出し、ツール名、いくつかの大まかな入力値（システム電圧、出力形式）、クライアントの製品名（例：claude-ai。MCP の clientInfo または HTTP の User-Agent から取得）です。プロンプト、これら以外のツール引数、IP アドレス由来の識別子は送信されません。無効にするには VOLTPLAN_TELEMETRY=off を設定してください。

例

examples/ にある、詳細なシナリオをご覧ください。

• ヨットの改装（30 ft、クルージング）
• Sprinter バンのキャンピングカー化
• オフグリッド小屋
• デイセーラー（最小構成）
• 船上居住（大電力負荷、AC ギャレー）

ロードマップ

• AC 側の計算：陸電入力、ブレーカーパネルのサイズ選定、絶縁変圧器
• 対応するバッテリーの化学組成を拡大：AGM／ゲルの容量曲線、鉛炭素
• 複数バンク構成：コンバイナー／DC-DC 充電器を使った始動用＋ハウス用バッテリー
• 配線経路の最適化：共用幹線、端子台の配置

関連リンク

• VoltPlan — 電気システムを視覚的に設計するウェブアプリ
• VoltPlan Wire Gauge Calculator — 無料、登録不要

概要

Stefan Lange-Hegermann が開発しました（yuzuhub.com）。VoltPlan を利用しています。

問題の報告、アイデア、プルリクエストは GitHub で歓迎します。

ライセンス

MIT — LICENSE を参照してください。