Vibe-Coding Hardware & Autonomous PCB Physical Synthesis MCP Server

Vibe-Coding Hardware MCP サーバー（vibe-hardware-mcp）

ローカルの KiCad .kicad_pcb および Specctra .dsn の解析、PCB 伝送線路インピーダンスと IPC-2152 電流の計算、ローカルでの製造性（DFM）ルール監査、マルチレイヤー PCB トレース配線に対応する、依存関係ゼロの Python 3 Model Context Protocol（MCP）サーバー（calligraphy_mcp_stdio.py）です。

---

アーキテクチャと搭載 MCP ツール（calligraphy_mcp_stdio.py）

このリポジトリには、依存関係ゼロの完全な Python 3 MCP サーバー実装が calligraphy_mcp_stdio.py に含まれています（Dockerfile を使用してコンテナ化されています）。

1. ローカル・オフラインの PCB 解析、インピーダンス、DFM ツール（実行はすべてローカル）

ツール名	実行環境	説明
analyze_kicad_pcb	ローカル Python	.kicad_pcb S 式ファイルをローカルで解析し、銅層スタックアップ（F.Cu、B.Cu、In1.Cu..）、基板外形寸法（mm 単位の Edge.Cuts）、フットプリント数、SMD/THT パッド数、ファインピッチ（<= 0.50 mm）パッド密度、ネットリスト数、配線済みトラック／アーク／ビアの統計情報を抽出します。
analyze_specctra_dsn	ローカル Python	Specctra .dsn 自動配線ファイルをローカルで解析し、単位、解像度、信号／電源層、基板境界の寸法、部品のピン数、ネット接続、設計ルールのクリアランス／幅を抽出します。
calculate_pcb_trace_impedance	ローカル Python	閉形式の IPC-2141A／Hammerstad-Jensen マイクロストリップおよびストリップライン特性インピーダンス（$Z_0$）、エッジ結合差動ペアインピーダンス（$Z_{\text{diff}}$）、伝搬遅延（ps/mm）、IPC-2152 の直流電流容量／温度上昇を求めるソルバーです。
audit_pcb_dfm_rules	ローカル Python	.kicad_pcb および .dsn のトレース幅、クリアランス、ビアのドリル径、環状リングをローカルで監査し、standard_2l、standard_4l、fine_hdi の製造上限（JLCPCB／PCBWay）と照合します。
calligraphy_list_gallery_boards	ローカル Python	検証済みのオープンソース参考 PCB 13 点の組み込みカタログを返します（配線完了率 100.0%、KiCad 標準の銅箔 DRC 違反 0 件）。

2. オプションのクラウドコプロセッサツール（マルチレイヤー 3D PCB 配線のオフロード）

完全な 3D トレース配線、G1 円弧の平滑化、ティアドロップによるパッド補強、Gerber／Excellon／IPC-D-356 .ZIP ファイルの一括生成が必要な高密度マルチレイヤー基板向けに、サーバーはオプションのコプロセッサツール（calligraphy_preflight_audit、calligraphy_compile_board、calligraphy_get_job_status、calligraphy_download_fab_bundle、calligraphy_route_pcb）も公開します。

---

クイックスタート（ローカル stdio と Docker）

オプション 1：Python 3 でローカル実行（stdio トランスポート）

外部の pip パッケージは不要です（Python 3.10 以降の標準ライブラリを使用します）。

{
  "mcpServers": {
    "vibe-hardware-mcp": {
      "command": "python3",
      "args": ["/path/to/vibe-hardware-mcp/calligraphy_mcp_stdio.py"]
    }
  }
}

オプション 2：Docker で実行（Dockerfile）

docker build -t vibe-hardware-mcp .
docker run -i --rm vibe-hardware-mcp

オプション 3：リモートの Streamable-HTTP エンドポイント（Claude Code／Cursor）

claude mcp add --transport http calligraphy-eda https://calligraphyeda.com/api/v1/mcp

---

ビジュアルによる実証：オープンソースベンチマーク 55 / 55 件を検証（PCBench Tier T 20 / 20 件 ＋ Tier D 13 / 13 件 ＋ Multi-ECAD 22 / 22 件を、完了率 100.0%・ネイティブ KiCad 9 DRC 0 件で達成）

PCBench Tier T 20 ボード ＆ Tier D 13 ボードのスコアボード全体： github.com/calligraphysystems/open-pcb-routing-benchmark

ベンチマークボード	350 DPI 配線済み銅箔の実証（DRC 0 件）	3D レイトレースによる組み立てレンダリング
Karabas-Nano（2 層、パッド 738 個、接続 928 本） 完了率 100.0% • 未接続 0 件 • KiCad DRC 0 件
Decelerator4030（パッド 908 個、接続 487 本、軸から外れた 45° の LQFP-100） 完了率 100.0% • 未接続 0 件 • KiCad DRC 0 件
Teensy MCU Breakout（高密度スルーホール ＋ SMD） 完了率 100.0% • 未接続 0 件 • KiCad DRC 0 件

---

ライセンス

MIT ライセンス — 著作権 (c) 2026 Calligraphy Systems LLC (https://calligraphyeda.com).