KiCad Agentic MCP

KiCAD 10向けのAI支援PCB設計。 KonnectはネイティブKiCADプラグインであり、単一のRustバイナリで、Claudeや他のAIアシスタントがModel Context Protocol (MCP)を通じて回路図やPCBを設計できるようにします。

22のオンデマンドツールセットにわたる202のツール。 回路図キャプチャ、PCBレイアウトと配線、ERC/DRC、設計レビュー監査、JLCPCB部品検索、Freerouting、リファレンス回路、そして完全な製造エクスポートパイプライン — 同梱のスキルとエージェントにより、ClaudeにKiCADの慣習をすぐに教えます。

このリポジトリはKiCad Agentic MCPであり、mixelpixx/Konnect v0.2.2のエージェンティックフォークで、同じAGPL-3.0ライセンスの下にあります。Konnectのツールサーフェスに加えて、MCPゲートウェイ、決定論的エグゼキュータを備えたプランIR、エビデンスハンドル、タスク状態、ローカルモデルランタイムを追加します。サーバーバイナリは依然としてkonnectと呼ばれます。

ステータス: v1.1.1。 何を測定し、何を見逃し、何をカバーしていないかはRELEASE_NOTES.mdにあります。以下に引用するすべての数値はdocs/benchmark.mdに由来します。問題やPRは歓迎します — CONTRIBUTING.mdと命名規則を参照してください。

1つのプロンプトでできること

1つのプロンプトで、examples/demo/にコミットされた開始ボード上で — 再現可能であり、例示ではありません。KiCadの判定であり、私たちのものではありません: 変更前は未接続アイテム5つ、変更後は0、トラックセグメント11、エラーなし。同じ状態から2回実行しても、回路は同じで、座標は異なります。

2つの数値は、異なるものを測定しているためです: ボードの変更は1秒未満（Konnect時間で0.69秒と0.77秒）で反映されますが、その周りのプロンプトは6〜7分かかります。モデルが1ターンに1セグメントを配線するためです。両方の実行は、呼び出しごとにdemo-run-2.mdとdemo-run-3.mdにあります。

Related MCP server: mcp-kicad-cli

クイックスタート

リリースページからKiCAD自身が確認する変更までの5つのステップ。Konnectがインストールされたことのないマシンで実行しました。何が問題だったかを含む記録はdocs/launch/first-run-walk.mdにあります。

そのウォークが測定したもの: KiCADの起動からプラグインのインストールまで約9回のクリックとダイアログ、KiCADの再起動2回、そして108 msで返ってきた最初のタスク。合計はクリックの速さに依存するため、数値としては引用されていません。

開始前に、KiCAD 10（10.0.3でテスト済み）とMCPクライアント — Claude Desktop、Claude Code、またはMCPを話す他のもの — が必要です。それ以外は不要です: NodeもPythonもパッケージツリーもありません。Windowsが最もテストされたプラットフォームです。macOSとLinuxの状況は要件を参照してください。

1 — プラグインパッケージをダウンロードします。 Releasesから、konnect-pcm-v<version>-windows.zip（または-macos.zip / -linux.zip）を取得します。konnect-pcm-*アセットはKiCADプラグインパッケージです。他のアーカイブはスタンドアロンサーバーバイナリであり、このパスでは必要ありません。

2 — インストールします。 KiCAD 10 → プラグインとコンテンツマネージャー → ファイルからインストール… → zipを選択します。ファイルを選択した瞬間にインストールされます — 保留中の変更を適用ボタンはグレーアウトされたままで、確認するものは他にありません。KiCADを再起動します。

3 — KiCAD APIを有効にします。 環境設定 → プラグイン → KiCad APIを有効にするにチェックを入れ、KiCADを再起動します。KiCADはこれをオフで出荷しており、ここにあるすべてのPCBツールはこれを通じてKiCADと通信します。回路図編集とエクスポートはこれなしで動作しますが、ライブボード編集は動作しません。再起動後、同じページにListening on ipc://…と表示されるはずです。

4 — MCPクライアントをサーバーに向けます。 PCMインストール後、バイナリはKiCADドキュメントフォルダーにあります:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

そのパスをクライアントのMCP設定に配置します — Claude Desktopの場合は%APPDATA%\Claude\claude_desktop_config.json、Claude Codeの場合はプロジェクトルートの.mcp.json。両方のコピーペースト版はexamples/にあり、完全なスニペットは下の方にあります。クライアントを再起動すると、konnectは起動時に21ツールを報告するはずです。それがスターターキット全体です — 残りのカタログはオンデマンドで読み込まれるか、tools/listに表示されることなくゲートウェイを介して呼び出されます。標準のKiCAD 10インストールでは**konnect-settings.jsonは不要**です: v1.1.1はkicad-cli、KiCAD GUIバイナリ、IPCアドレスを自動検出します。明示的な設定は、特殊なインストールやポータブルインストールのために引き続き利用できます。

5 — 何か作業を与えます、KiCADプロジェクトを開いた状態で。例:

私の回路図に3.3 V LDOレギュレータサブ回路を追加し、ERCを実行してください。

返信には、配置した部品（レギュレータ、その入力および出力コンデンサ）の名前が含まれ、kicad-cliから得られたERC結果が含まれるはずです（モデルからではありません）。KiCADで回路図を開くと、シンボルがそこにあります。

インストール自体を確認するには、いつでも: プロジェクトを開き（KiCADのPCBエディタはプロジェクトなしでは開きません）、次にPCBエディタ → ツール → 外部プラグインで、Konnectが表示されるはずです。

まだできないこと

• PCBツールは、APIが有効でボードが開いている実行中のKiCADが必要です。 ヘッドレスPCBパスはありません — pcbnewにはありません。

• macOSバイナリは署名も公証もされていません。 Gatekeeperが最初の起動時に停止します。macOSセクションに正確なxattrコマンドがあります。

• LinuxはコンパイルされCIを通過しますが、実行中のKiCADに対するプラットフォーム別のQAは行われていません。

• シンボルとフットプリントは配置されるものであり、作成されるものではありません。 Konnectは既存のライブラリ部品を検索して使用します。新しいものの作成はロードマップにあります。

その5つのステップのいずれかがうまくいかなかった場合、それが報告する価値のあることです: 初回実行レポートを提出してください。約2分かかり、メンテナのマシン以外でこれが測定される唯一の方法です。

Konnectが存在する理由

KonnectはKiCAD-MCP-Serverの後継であり、AI駆動のPCB設計が機能することを証明したPython/TypeScriptプロジェクトです — そしてその過程で、そのアーキテクチャがどこで行き詰まるかを正確に示しました。Konnectはこれらの具体的な問題を修正するために構築されました:

呼び出しパスが長すぎました。 元のサーバーでは、単一のツール呼び出しは、TypeScript、スキーマ検証、生成されたPythonサブプロセス、stdin/stdout上のJSON、コマンドルーター、そして最終的にSWIG生成のC++プロキシオブジェクトを経由してから、ボードに触れます。これは4つの言語とシリアライゼーションの境界であり、それぞれに独自の障害モードがあります — サブプロセスのライフサイクル管理、KiCADがストリームに漏らす警告をフィルタリングするstdout解析、チャンク化されたJSONの再組み立て。Konnectでは、ツール呼び出しは関数呼び出しです。1つのプロセス、1つの言語、配管はありません。

依存関係の表面は巨大でした。 元のものを実行するには、Node.jsとそのnpmツリー、Pythonとそのpipパッケージ、wxPython、kicad-skip、そしてKiCADのSWIGバインディングを保持する必要があります — 2つのパッケージエコシステムとバインディングレイヤーがあり、そのすべてがインストールを壊す可能性のある動く標的です。Konnectは1つのバイナリです — Windowsでは24 MB、インタープリタなし、パッケージツリーなし。それに加えてインストールするものも、バージョンを一致させるものもありません。

SWIGは行き止まりです。 元のPCBバックエンドはKiCADのSWIG Pythonバインディングに依存していますが、KiCADはIPC APIを優先してこれを非推奨にしています。SWIGには実際の運用上の傷跡もありました: バックエンドをセグメンテーションフォールトさせる可能性のあるゾーンフィル呼び出し、プロキシオブジェクトの比較バグ、セッション中にバックエンドを静かに切り替える可能性のあるフォールバックパス。Konnectは公式のIPC API（NNG上のprotobuf）を介してKiCAD 10と通信します — KiCADが投資しているインターフェース — リアルタイムのボード編集で、KiCAD自身のundo/redoと統合されます。

回路図編集はファイルを破損させてはなりません。 Konnectは独自のS式エンジンを使用して.kicad_schファイルを編集し、アトミック書き込み（書き込み、fsync、リネーム）、UUIDの保持、ラウンドトリップテストを備えています — 既知のギャップがあるサードパーティの回路図ライブラリも、テキスト操作の回避策もありません。

コンテキスト経済は機能です。 カタログ全体（すべてのツールセットが読み込まれると215ツール）を提供すると、リストごとに33Kトークンのコンテキストがかかります。Konnectのルーターは21ツール / 2.8Kトークンのスターターキットで始まり、モデルがオンデマンドでツールセットを引き込むか、カタログを完全にスキップしてゲートウェイ（kicad_describe / kicad_invoke）を介してツールを呼び出すことができます。これはtools/listをまったく変更しません — さらに、組み込みの可観測性（get_recent_calls、server_stats、JSONL呼び出しログ）により、モデルは自身のツール障害を診断できます。これらの数値は推定ではなく測定されたものです: docs/benchmark.mdを参照してください。

その結果、より小さく、インストールが速く、KiCADの進む方向に沿っており、実験ではなく本番使用向けに構築されています。元のプロジェクトはオープンで、維持され、有用なままです — 以下の比較を参照してください。

できること

変更を説明して手動で適用する代わりに、AIはプロジェクトを直接操作します:

• 回路図コンポーネントの配置と配線 — 抵抗、IC、コネクタを追加し、ピン名で配線します

• PCBレイアウト — KiCADのIPC APIを介してフットプリントをリアルタイムで配置、移動、回転、配線し、完全なundo/redo統合を備えています

• 設計チェックの実行 — ERC、DRC、接続性検証、デカップリング監査、電源レールレビュー、BOM健全性チェック

• 製造ファイルのエクスポート — Gerber、ドリル、BOM、ピックアンドプレース、3Dモデル、PDF

• JLCPCB部品の検索 — ローカルの250万部品カタログで在庫のあるコンポーネントを見つけ、代替案を提案します

• リファレンス回路から開始 — USB-C、LDO、バックコンバータ、STM32、I2C、LEDテンプレート（検証済みの部品値付き）

• 進行状況を確認 — ライブ回路図ビューアがAIの編集に合わせて自動更新されます

完全なツールカタログはtool-directory.mdに文書化されています。

仕組み

インストール

KiCADプラグインマネージャーから（推奨）

1. Releases からお使いのOS用のパッケージをダウンロードします: konnect-pcm-v<version>-windows.zip、-macos.zip、または -linux.zip。それぞれに そのプラットフォーム用のサーバーバイナリが同梱されています — macOS パッケージはユニバーサルビルドなので、 1つのダウンロードで Apple Silicon と Intel の両方に対応します。(konnect-pcm-* アセットは KiCAD プラグインパッケージで、他のアーカイブはスタンドアロンの サーバーバイナリです。)

2. KiCAD 10 を開き、Plugin and Content Manager を選択

3. Install from File をクリックして zip を選択します。インストールは選択時に 実行されます — Apply Pending Changes はグレーアウトしたままで、確認するものは 他にありません

4. KiCAD を再起動します

5. KiCAD API を有効にします: Preferences → Plugins → Enable KiCad API を選択し、 再度 KiCAD を再起動します。初期状態ではオフになっており、すべての PCB ツールで必要です

確認: プロジェクトを開く(または作成する)— KiCAD の PCB エディタはプロジェクトが ないと開きません — 次に PCB Editor → Tools → External Plugins → Konnect が表示されるはずです。

ソースからのビルド

# protoc is required (protobuf code generation), and cmake (the nng crate
# compiles the NNG C library with it).
# Windows: choco install protoc cmake
# macOS:   brew install protobuf cmake
# Linux:   apt install protobuf-compiler cmake
cargo build --release -p konnect

macOS

Releases ページには Apple Silicon (aarch64-apple-darwin) と Intel (x86_64-apple-darwin) の両方の スタンドアロンサーバーバイナリが用意されています。これらはまだコード署名されていないため、 ブラウザ経由でダウンロードした場合は、初回起動前に quarantine フラグを解除してください:

tar xzf konnect-v*-aarch64-apple-darwin.tar.gz
xattr -d com.apple.quarantine ./konnect   # only needed for browser downloads
./konnect --help

または上記のようにソースからビルドします(Apple Silicon で検証済み。同じ target/release/konnect バイナリが MCP サーバーです)。

macOS の KiCAD はツールをアプリバンドル内に保持しており、PATH には含まれません。 v1.1.1 は標準のアプリバンドルを検索し、KiCAD のデフォルトの IPC アドレスを自動的に使用します。 特殊な場所や名前を変更したインストールの場合のみ、~/Library/Application Support/konnect/config.toml で 明示的な上書きが必要です:

kicad_cli = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli"
kicad_binary = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad"
# Optional override; the default is ipc:///tmp/kicad/api.sock.
ipc_address = "ipc:///tmp/kicad/api.sock"

Claude Desktop の設定は ~/Library/Application Support/Claude/claude_desktop_config.json にあります:

{
  "mcpServers": {
    "konnect": {
      "command": "/path/to/konnect"
    }
  }
}

Claude Code の場合は、プロジェクトルートの .mcp.json に同じスニペットを配置します。

macOS 用の PCM パッケージ(konnect-pcm-v<version>-macos.zip)には ユニバーサルサーバーバイナリが同梱されているため、1つのダウンロードで両方のアーキテクチャに対応します。 回路図ビューアは macOS でコンパイルおよび起動します(Tauri 2 はシステムの WKWebView を使用 — WebView2 は Windows のみの要件です)が、Windows ビルドほどの実績はまだありません。

Claude Desktop でのセットアップ

PCM インストール後、サーバーバイナリは KiCAD ドキュメントフォルダに配置されます:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

%APPDATA%\Claude\claude_desktop_config.json を編集します:

{
  "mcpServers": {
    "konnect": {
      "command": "C:\\Users\\<YOU>\\Documents\\KiCad\\10.0\\3rdparty\\plugins\\com_github_mixelpixx_konnect\\bin\\konnect.exe"
    }
  }
}

Claude Desktop を再起動すると Konnect ツールが表示されます。Claude Code の場合は、 同じスニペットをプロジェクトルートの .mcp.json に配置します(examples/ を参照)。

回路図ビューア

回路図ファイルの変更に応じて自動更新されるスタンドアロンビューア:

schematic-viewer.exe path\to\your\root_schematic.kicad_sch

階層設計のルートシートを指定すると、すべてのサブシートもレンダリングされ、 ツールバーに深さインデント付きのシートセレクタが表示されます。KiCAD から保存された編集(または AI が回路図ツールを通じて行った編集)は、変更されたシートのみを再レンダリングし、 ビューをライブで更新します — レンダリングは一時フォルダのスナップショットに対して実行されるため、 ビューアが KiCAD の保存をブロックすることはありません。クリックドラッグでパン、ホイールでズーム、 0 でフィット、R で更新、ドラッグアンドドロップで別のファイルを開きます。また、 AI が open_schematic_viewer ツール経由で起動することもできます。

WebView2 ランタイム(Windows 10/11 にプリインストール済み)と、kicad-cli 用の KiCAD インストール (自動検出、または --kicad-cli <path> で指定)が必要です。メインワークスペースとは別にビルドされます — ビルド手順は DEV.md を参照してください。

要件

• KiCAD 10(Windows が最もテストされたプラットフォーム。macOS はリリース バイナリまたはソースビルドで動作します — 上記の macOS セクション を参照。Linux は CI でコンパイルおよびテストに合格していますが、プラットフォーム別の QA はまだ実施されていません。両方とも ロードマップ で追跡されています)

• kicad-cli(KiCAD に同梱 — エクスポート、ERC、DRC に使用)。KiCAD のインストーラは PATH に追加しないため、サーバーは通常のインストール場所を検索します。 別の場所にある場合は明示的に指定できます

• PCB ツールの場合: 対象のボードを開いた状態で KiCAD が実行されていること、かつ KiCAD API が 有効になっていること — Preferences → Plugins → Enable KiCad API。初期状態ではオフです

ライセンス: 小規模ユーザーは無料

Konnect は GNU AGPL-3.0 の下でライセンスされています。

趣味、学生、フリーランサー、オープンソースプロジェクトの場合: 自由に使用できます。 条件はありません。 ボードを設計し、出荷し、販売できます。

企業の場合: AGPL では、Konnect を基に構築または周辺で提供するもの(ネットワーク経由で 提供されるソフトウェアを含む)は、同じライセンスの下でオープンソース化する必要があります。 それが合わない場合は、商用ライセンスが利用可能です: COMMERCIAL.md を参照してください。

KiCAD-MCP-Server との関係

元の Python/TypeScript プロジェクト は 完全にオープン(MIT)で、メンテナンスも継続されています。Konnect は新しい開発が行われる場所です — そこで実証されたアーキテクチャを、本番用に再構築したものです:

トラブルシューティング

プラグインが KiCAD に表示されない — Plugin and Content Manager からインストールし (手動コピーではなく)、KiCAD を再起動します。エントリは PCB エディタ の Tools → External Plugins にあります。PCB エディタはプロジェクトが開かれるまで まったく開きません。

PCB ツールが「IPC connect failed」を返す — 2つの別々の条件が両方とも満たされている必要があります: Preferences → Plugins → Enable KiCad API がチェックされていること(KiCAD は初期状態で オフ)、および KiCAD がボードファイルを開いた状態で実行されていること。API ページは 再起動後に Listening on ipc://… と表示されるはずです。 docs/TROUBLESHOOTING.md で両方の手順を説明しています。

「Failed to spawn kicad-cli」 — サーバーは kicad-cli を次の順序で探します: 設定で kicad_cli 値を設定している場合はそれ、次に PATH、次に既知の インストールプレフィックス(%LOCALAPPDATA%\Programs\KiCad\<ver>\bin を含む。ここは KiCAD のインストーラがユーザー単位のインストールを配置する場所)、最後に Windows レジストリ。 起動時にどれが応答したかをログに記録します。どれも応答しない場合 — 特殊なインストール場所や ポータブルコピーなど — プラグイン設定ダイアログまたは設定ファイルで kicad_cli を 明示的に設定してください。

バリデータがゼロ件ではなくエラーを報告する — これは意図的な動作です。 実行できなかったチェックが、実行に成功したチェックとして報告されることはありません。

サポート

• 初めてお試しですか? 初回使用レポートを提出 — 6つの質問で、ほとんどがワンクリックです。諦めた人からのレポートは、 成功した人からのレポートよりも価値があります。返ってきた内容は docs/adoption.md に集計されます。

• バグと機能リクエスト: GitHub Issues

• インストールや IPC ソケットで行き詰まった場合: docs/TROUBLESHOOTING.md

• ロードマップ: ROADMAP.md

• コントリビューション: CONTRIBUTING.md

テレメトリはありません。 Konnect は何も、どこにも、決して報告しません。 他の人のマシンでの動作について知られているすべてのことは、誰かがそれを書き留めることを 選択したことによるものです。設計ファイルを編集するツールは、外部に通信しないことで 信頼を得ます。