KiCAD-MCP-Server

KiCAD MCP: AI支援PCB設計

KiCAD MCPは、Claudeのような大規模言語モデル（LLM）がKiCADと直接連携してプリント基板設計を行えるようにするモデルコンテキストプロトコル（MCP）実装です。AIアシスタントとKiCAD PCB設計ソフトウェアの間に標準化された通信ブリッジを構築し、高度なPCB設計操作を自然言語で制御できるようにします。

また、Google-Search-MCP もここにあり、Google 検索を実行してページを表示できます。

https://github.com/mixelpixx/Google-Search-MCP-Server

KiCAD MCPプロジェクトのステータス

• KiCAD 9.0との完全なPythonインターフェース互換性を実装しました
• モジュール式で保守可能なコンポーネントアーキテクチャを作成
• ボード操作、コンポーネント配置、配線のための包括的なツールを実装しました
• プロジェクトの作成からコンポーネントの配置とルーティングまでの操作が正常にテストされました
• KiCADに確実にコマンドを渡す、合理化されたMCPサーバー実装を作成しました

サーバーは Cline/Claude とシームレスに連携し、自然言語による AI 支援の PCB 設計を可能にします。

何をするのか

KiCAD MCP は、AI アシスタントを有効にして、エンジニアと設計者が KiCAD で作業する方法を変革します。

• 自然言語リクエストを通じて KiCAD PCB プロジェクトを作成および管理します
• ボードの形状、アウトライン、レイヤー、プロパティを操作する
• さまざまなパターン（グリッド、円形、整列）でコンポーネントを配置および整理します
• トレース、差動ペアを配線し、銅箔を作成する
• 設計ルールを実装し、設計ルールチェックを実行する
• さまざまな形式（Gerber、PDF、SVG、3D モデル）でエクスポートを生成
• AIアシスタントに回路基板に関する包括的なコンテキストを提供する

これにより、自然言語駆動型の PCB 設計ワークフローが可能になり、エンジニアによる完全な監視と制御を維持しながら、複雑な操作を平易な英語で要求できるようになります。

コアアーキテクチャ

• TypeScript MCP サーバー: Claude やその他の互換性のある AI アシスタントと通信するための Anthropic Model Context Protocol 仕様を実装します。
• Python KiCAD インターフェース: 包括的なエラー処理を備えた pcbnew Python API を介して実際の KiCAD 操作を処理します。
• モジュラー設計: 保守性と拡張性を考慮して、機能をドメイン（プロジェクト、ボード、コンポーネント、ルーティング）ごとに整理します。

システム要件

• KiCAD 9.0 以上（完全にインストールされている必要があります）
• Node.js v18以上およびnpm
• Python 3.8 以降とpip (KiCAD 9.0 に付属のバージョンで十分です)
• Cline (VSCode Claude 拡張機能) または他の MCP 互換クライアント
• Windows 10/11 (現在のバージョンは Windows 向けに最適化されていますが、Linux/Mac のサポートも予定されています)

インストール

ステップ1: KiCAD 9.0をインストールする

1. KiCAD 9.0 をKiCAD の公式ウェブサイトからダウンロードします。
2. インストーラーを実行し、デフォルトのインストールオプションを選択します
3. Python モジュールがインストールされていることを確認します (これはデフォルトのインストールに含まれています)

ステップ2: KiCAD MCPリポジトリのクローンとセットアップ

ステップ3: Cline (VSCode Claude拡張機能) を構成する

1. まだインストールされていない場合は、公式サイトからVSCodeをインストールしてください。
2. VSCodeマーケットプレイスからCline拡張機能（VSCode用Claude）をインストールします。
3. Cline MCP 設定ファイルを編集します。
   • Windows: %USERPROFILE%\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
4. 次の構成をファイルに追加します (システムの必要に応じてパスを更新します)。

5. 変更を有効にするには、VSCode を再起動するか、ウィンドウを再読み込みしてください。

ステップ4: インストールの確認

1. Cline拡張機能でVSCodeを開く
2. クロードと新しい会話を始める
3. Claude に新しい KiCAD プロジェクトを作成するように依頼します。
   Create a new KiCAD project named 'TestProject' in the 'test' directory.
4. クロードはKiCAD MCPを使用してプロジェクトを作成し、成功を報告する必要があります。

使用例

KiCAD MCP を使用して Claude に依頼できる作業の例をいくつか示します。

プロジェクト管理

ボードデザイン

部品配置

ルーティング

デザインルールとエクスポート

カテゴリー別の機能

プロジェクト管理

• カスタマイズ可能な設定で新しい KiCAD プロジェクトを作成する
• ファイルパスから既存の KiCAD プロジェクトを開く
• オプションの新しい場所を指定してプロジェクトを保存する
• プロジェクトのメタデータとプロパティを取得する

ボードデザイン

• メートル法とヤードポンド法をサポートし、正確なボード寸法を設定できます
• カスタムボードアウトライン（長方形、角丸長方形、円、多角形）を追加します
• さまざまな構成のボードレイヤーを作成および管理します
• 取り付け穴、テキスト注釈、その他のボード機能を追加する
• 現在のボードの状態を視覚化する

コンポーネント

• 指定されたフットプリントを持つコンポーネントを正確な位置に配置します
• グリッドまたは円形パターンでコンポーネント配列を作成する
• 既存のコンポーネントを移動、回転、変更する
• コンポーネントを均等に整列させて分配する
• カスタマイズ可能なプロパティを持つコンポーネントを複製する
• 詳細なコンポーネントのプロパティとリストを取得する

ルーティング

• 特定のプロパティを持つネットを作成および管理する
• コンポーネントパッド間または任意のポイント間のトレースを配線する
• ブラインドビアや埋め込みビアを含むビアを追加する
• 高速信号用の差動ペアルートを作成する
• 銅箔（グランドプレーン、電源プレーン）を生成する
• 特定の設計ルールでネットクラスを定義する

デザインルール

• クリアランス、トラック幅などのグローバル設計ルールを設定します。
• 異なるネットクラスに特定のルールを定義する
• 設計ルールチェック（DRC）を実行して設計を検証する
• DRC違反の表示と管理

輸出

• 製造用の業界標準のガーバーファイルを生成
• PCBのPDFドキュメントをエクスポートする
• ボードのSVGベクターグラフィックを作成する
• STEP または VRML 形式で 3D モデルを生成します
• さまざまな形式で部品表（BOM）を作成します

実装の詳細

KiCAD MCP 実装では、モジュール式の保守可能なアーキテクチャが使用されます。

TypeScript MCP サーバー (Node.js)

• kicad-server.ts : MCPプロトコルを実装するメインサーバー
• Clineとの信頼性の高い通信のためにSTDIOトランスポートを使用する
• KiCAD 操作の Python プロセスを管理します
• コマンドキューイング、エラー回復、応答フォーマットを処理

Pythonインターフェース

• kicad_interface.py : 次の機能を果たすメインの Python インターフェース:
  • stdin経由でJSONとして受信したコマンドを解析します
  • コマンドを適切な専用ハンドラーにルーティングします
  • 結果をstdout経由でJSONとして返します
  • 詳細な情報でエラーを適切に処理します
• モジュラーコマンド構造:
  • commands/project.py : プロジェクトの作成、開く、保存
  • commands/board/ : モジュール式ボード操作関数
    • size.py : ボードサイズの操作
    • layers.py : レイヤー管理
    • outline.py : ボードのアウトライン作成
    • view.py : 可視化関数
  • commands/component.py : コンポーネントの配置と操作
  • commands/routing.py : トレースルーティングとネット管理
  • commands/design_rules.py : DRCとルールの設定
  • commands/export.py : さまざまな形式での出力生成

このアーキテクチャにより、クリーンかつ一貫性のあるインターフェース レイヤーを維持しながら、PCB 設計の各側面が専用モジュールによって処理されるようになります。

トラブルシューティング

よくある問題と解決策

問題: KiCAD MCP が Claude のツールに表示されない

• Cline MCP設定を更新した後、VSCodeが完全に再起動されていることを確認してください。
• 設定内のパスがシステムに合っているか確認します
• npm run build正常に完了したことを確認します

問題: サーバーの起動時に Node.js エラーが発生する

• Node.js v18以降を使用していることを確認してください
• すべての依存関係が適切にインストールされていることを確認するために、 npm install再度実行してみてください。
• コンソール出力で具体的なエラーメッセージを確認します

問題: PythonエラーまたはKiCADコマンドが失敗する

• KiCAD 9.0が正しくインストールされていることを確認する
• 設定内のPYTHONPATHが正しい場所を指していることを確認してください
• pcbnewモジュールにアクセスできることを確認するために、簡単なKiCAD Pythonスクリプトを直接実行してみてください。

問題: Claude が KiCAD プロジェクトを見つけられない、または読み込めない

• プロジェクトの場所を参照するときは絶対パスを使用します
• VSCodeを実行しているユーザーがディレクトリへのアクセス権限を持っていることを確認する

ヘルプの取得

このトラブルシューティングのセクションで説明されていない問題が発生した場合:

1. コンソール出力でエラーメッセージを確認します
2. GitHubリポジトリのIssuesセクションで同様の問題を探します
3. 問題に関する詳細情報を記載した新しい問題を開く

貢献

このプロジェクトへの貢献を歓迎します！ご協力いただける方法は以下の通りです。

1. バグ報告: 何が問題で、どのように再現したかを記載した問題を報告してください
2. 機能の提案: アイデアをお持ちですか? Issue で共有してください
3. プル リクエストを送信: バグを修正しましたか? または機能を追加しましたか? PR を送信してください。
4. ドキュメントの改善: ドキュメントの明確化や拡張にご協力ください

既存のコード スタイルに従い、新しい機能のテストを含めてください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。