KiCad Copilot

Name: KiCad Copilot
Author: biosshot

ローカル

github.com/biosshot科学・教育219 週間前に更新

リポジトリ

KiCad Copilot について

KiCad Copilot は KiCad の設計ファイルを扱う MCP サーバーです。AI エージェントによる回路図の作成・編集や PCB 配置・配線を支援し、ファイルベースの操作、復元可能なチェックポイント、ローカル配線に対応します。

主な機能

01回路図の生成と編集
02コンポーネント検索と回路ブロック挿入
03階層プロジェクトとチェックポイント作成
04PCB 配置の生成と確認
05ローカル PCB 配線と銅箔ゾーン作成
06KiCad CLI による検査とエクスポート

活用シーン

01自然言語で KiCad 回路図を編集
02複数シートの回路ブロックを再構成
03PCB 部品配置をプレビューして適用
04ローカル配線後にデザインルール検査

MCP 対応

KiCad プロジェクト、回路図、PCB を操作する MCP ツールを AI エージェントに提供し、分析、配置、ローカル配線に対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "biosshot-kicad-copilot": {
      "command": "npx",
      "args": [
        "-y",
        "kicad-copilot-mcp"
      ]
    }
  }
}

起動コマンドnpx -y kicad-copilot-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmkicad-copilot-mcp0.1.0stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
MPN	string\|null	いいえ
part_uuid	string\|null	いいえ

詳細

KiCad Copilot

KiCad 向けの AI 搭載 MCP サーバーです。自然言語で回路図を作成・変更し、実在するコンポーネントを検索し、階層型プロジェクトを扱い、PCB 配置を生成し、ローカルで基板を配線し、AI エージェントから直接シンプルな銅箔ゾーンを作成できます。

KiCad Copilot は、EasyEDA Copilot の KiCad 版です。同じ中核となる回路生成機能と PCB 自動化機能を備え、ファイルベースの階層型プロジェクト、復元可能なチェックポイント、ネイティブな kicad-cli 統合、完全ローカルでの PCB 配線にも対応しています。

統合解析： KiCad Copilot は、analyze_schematic または analyze_pcb を初めて使用する際に、固定バージョンで検証済みの kicad-happy v2.2.0 リリースをダウンロードします。MCP ツールは、トークン効率の高い簡潔な実行可能な指摘事項と、焦点を絞った設計データを返します。

できること

KiCad Copilot は、AI エージェントに KiCad を操作するための高水準なファイルベースのインターフェースを提供します。

回路図の生成と変更：KiCad のオブジェクトを一つずつ編集することなく、実在するコンポーネントの追加、削除、置換、接続ができます。
回路図ブロックの再構築：電気的な接続を維持したまま、選択したコンポーネントを再編成できます。
コンポーネントと再利用可能なブロックの検索：MPN またはパーツ UUID でコンポーネントを特定し、実績のある機能回路を挿入できます。
KiCad プロジェクトの操作：プロジェクトツリーを調べ、プロジェクト、単独の回路図、階層シート、PCB ファイルを作成できます。
復元可能なチェックポイントの保持：個々の KiCad ファイルの正確なバージョンを保存、一覧表示、復元できます。
回路図と PCB の同期：回路図の変更を関連する基板に明示的にインポートできます。
PCB 配置の生成：コンパクトな JavaScript DSL で基板の制約を記述し、PNG／SVG プレビューを確認して、承認した結果を適用できます。
ローカルでの配線：管理対象の KRT バックエンドとともに eda-copilot-router を使用し、配線処理を外部サービスに送信せずに実行できます。
銅箔ゾーンの作成：必要に応じてステッチングビアを追加し、基板全体を覆うシンプルなゾーンを作成できます。
KiCad のネイティブツールの使用：ERC、DRC、プレビュー、エクスポート、製造用ファイル、その他のネイティブ操作に使用する kicad-cli を検出できます。

KiCad Copilot は、保存済みの .kicad_pro、.kicad_sch、.kicad_pcb ファイルを直接操作します。KiCad IPC や、KiCad 内にインストールするプラグインは必要ありません。

使用例

これらのプロジェクトは KiCad Copilot を通じて生成・反復開発されました。KiCad のソースファイル一式は examples ディレクトリにあります。

ATmega328P 開発ボード

MCU コア、クロック、リセット、デカップリング、USB-UART 電源、Nano 互換ヘッダー、デバッグ接続を機能別のシートに分けた、階層型の ATmega328P 設計です。

_{プロジェクトの概要}	_{USB-UART と電源}
_{MCU コア}	_{Nano ヘッダーおよびデバッグ}

ATmega328P プロジェクトをダウンロード

ガイガー高電圧電源

電源入力、3.3 V レギュレーション、高電圧ジェネレーター、フライバック段、フィードバック、検出器、コントローラー、ユーザーインターフェースを扱う、大規模な複数シート設計です。

_{プロジェクトの概要}	_電源入力
_{高電圧ジェネレーター}	_検出器
_{コントローラー UI}	_{3.3 V 電源}
_{HV フライバック}	_{HV フィードバック}
_{ユーザーインターフェース}

ガイガー高電圧プロジェクトをダウンロード

RP2350 開発ボード

電源、クロック、フラッシュ、USB／デバッグ、GPIO ヘッダーを備え、AI が生成した PCB 配置を含む階層型 RP2350 設計です。この例には、配置 DSL と編集可能な KiCad ボードが含まれています。

_{プロジェクトの概要}	_電源
_{RP2350 とクロック}	_{フラッシュ}
_{USB とデバッグ}	_{GPIO ヘッダー}

KiCad Copilot で生成した RP2350 PCB 配置の 3D レンダリング
_{生成された PCB 配置の KiCad 3D レンダリング}

RP2350 プロジェクトをダウンロード

インストール

MCP サーバーを AI エージェントに追加します。

Codex：

codex mcp add kicad-copilot -- npx -y kicad-copilot-mcp

Claude Code：

claude mcp add kicad-copilot -- npx -y kicad-copilot-mcp

汎用 MCP 設定：

{
  "mcpServers": {
    "kicad-copilot": {
      "command": "npx",
      "args": ["-y", "kicad-copilot-mcp"]
    }
  }
}

サーバーを追加した後、MCP クライアントを再起動してください。KiCad Copilot にはエージェント向けのローカルワークフロー文書が含まれており、ツールの説明からインストール先のパスを自動的に確認できます。

要件

Node.js 20 以降
KiCad 9 または 10
管理対象の EasyEDA2KiCad のインストールおよび kicad-happy による解析に必要な Python 3

KiCad Copilot は PATH と標準の KiCad インストール先で kicad-cli を検索し、対応バージョンが複数インストールされている場合は KiCad 10 を優先します。実行可能ファイルが別の場所にある場合は、KICAD_CLI_PATH を設定してください。

実コンポーネントへの変換を初めて行う際は、既存の EasyEDA2KiCad インストールを使用するか、管理対象のローカル仮想環境に自動でインストールします。

設計解析を初めて呼び出すと、アーカイブサイズと SHA-256 ハッシュを検証したうえで、固定された kicad-happy リリースが共有 EDA Copilot アセットキャッシュにダウンロードされます。代わりに信頼できるローカルチェックアウトを使用するには、 KICAD_HAPPY_DIR を設定してください。

回路図のワークフロー

エージェントに KiCad プロジェクトを調査するよう依頼するか、対象の .kicad_sch ファイルのパスを指定します。一般的な依頼は次のように簡潔に記述できます。

Open D:\Projects\sensor\sensor.kicad_pro and add a 3.3 V regulator block to the Power sheet.

エージェントは、プロジェクトツリーを調査し、対象シートをコンポーネントとネットのコンパクトな JSON として読み取り、正確なコンポーネントを検索し、依頼された変更を組み立て、保存された結果を KiCad で検証できます。

階層型プロジェクトでは、引き続きファイル単位で操作します。各物理回路図シートは、それぞれの .kicad_sch パスを通じて変更されます。一方、操作に完全な信号マップが必要な場合は、プロジェクト全体のコンテキストが使用されます。

ファイルの同期

KiCad Copilot はディスク上のファイルを変更します。KiCad は、すでに開いているエディターで未保存の新しい編集内容と、それらの変更を確実に統合できるとは限りません。

書き込みの前に：

KiCad で必要な変更を保存します。
新しい作業内容の唯一のコピーをエディターバッファに残さないでください。

書き込みの後に：

KiCad でドキュメントを再読み込み、元に戻す、または開き直します。
更新されたファイルを古いエディターバッファで上書きしないでください。

PCB ワークフロー

PCB の配置と配線では、明示的なレビューのフローを使用します。

回路図の変更を対象の .kicad_pcb ファイルにインポートします。
配置 DSL で外形、穴、制約、領域、重要なコンポーネントを記述します。
PCB を変更せずに機械的なプレビューを生成します。
返された PNG または SVG のプレビューをレビューします。
配置全体を生成して承認します。
保存された配置を PCB に適用します。
残りの接続をローカルで配線します。
結果を確認し、最後に KiCad DRC を実行します。

PCB を含む配置レスポンスはすべて、プレビューや問題を含む結果も含めてチェックポイントに保存され、アトミックに適用されます。エージェントは返されたプレビューまたは PCB の解析結果を確認し、必要に応じてチェックポイントを使ってロールバックできます。別途、アセンブリツールを呼び出す必要はありません。

配置 DSL とルーター DSL の実行は、別々の操作です。これにより、回路図から PCB への同期が明示され、配置済みコンポーネントを削除せずに配線を消去または再構築できます。

KiCad CLI

get_project_info は、検出された kicad-cli のパスとバージョンを報告します。KiCad がすでに操作を提供している場合、エージェントは次のような操作にネイティブ CLI を使用してください。

回路図 ERC と PCB DRC
回路図および PCB の PDF／SVG エクスポート
3D PCB レンダリング
ガーバーおよびドリルデータの生成
BOM、位置、STEP、STL、GLB、VRML のエクスポート
プロジェクトのジョブセットとフォーマットのアップグレード

すぐに使えるコマンドについては、KiCad CLI ワークフローを参照してください。

設計解析

analyze_schematic はオフラインの回路図チェックを実行し、トップレベルの概要、階層、ブロック、接続性、電源、バス、BOM、アセンブリ、検証に関する詳細なデータを返せます。 analyze_pcb は関連付けられた回路図の情報で PCB 解析を自動的に補完し、ドメイン横断チェックを実行します。また、オプションで熱、EMC、トレース近接解析を追加できます。個別のブール値フラグで、各オプションのレポート項目を制御できます。コンパクトな解析結果はデフォルトで有効です。実行時間の長い PCB レイアウト、PCB 配線、ライフサイクル監査では、pcb-dsl:1a2b3c4d のような接頭辞付きの operation_id が返されます。wait_operation を使って処理を続行し、不要になった処理は cancel_operation で停止してください。これらのツールは、内部ルール識別子、実行時メトリクス、座標レベルの銅箔データを LLM のレスポンスから除外します。

コンパクトな結果の仕様とワークフローの詳細については、設計解析を参照してください。

互換性

KiCad バージョン	状態
KiCad 10	サポート対象
KiCad 9	サポート対象

現在の実装では、その他のメジャーバージョンのファイル形式と CLI の動作をサポートしていないため、拒否されます。

ドキュメント

開発

git clone https://github.com/biosshot/kicad-copilot.git
cd kicad-copilot
npm install
npm run check
npm start

MCP Inspector は次のコマンドで実行します。

npm run inspect

このリポジトリには、使い捨てファイルを使った開発用に、回路図、PCB、配線に特化したテストスクリプトも含まれています。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: biosshot
言語: node
バージョン: 0.1.0
トランスポート: stdio
掲載日: 2026年8月9日
最終更新: 9 週間前
公式 Registry: io.github.biosshot/kicad-copilot

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

KiCad Copilot

KiCad Copilot について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

KiCad Copilot

できること

使用例

ATmega328P 開発ボード

ガイガー高電圧電源

RP2350 開発ボード

インストール

要件

回路図のワークフロー

ファイルの同期

PCB ワークフロー

KiCad CLI

設計解析

互換性

ドキュメント

開発

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？