Kicad MCP Server

🚀 KiCAD 設計自動化プロトコル (MCP) 日本語ドキュメント

KiCAD 設計自動化プロトコル (MCP) は、コマンドラインインターフェースを通じて KiCAD ソフトウェアを制御し、PCB 設計を行う方法を提供します。このプロトコルは Claire（Claude）ツールと統合されており、ユーザーがカスタムコマンドを使用して PCB 設計の自動化を実現できます。

主な機能は以下の通りです：

• KiCAD プロジェクトの作成、開閉、保存
• PCB レイヤーと設計ルールの管理
• 自動配線と部品配置
• Gerber ファイルなどの設計ドキュメントの一括エクスポート

✨ 主な機能

MCP 通信プロトコル

1. リクエスト形式：JSON 形式のコマンドパケット

{
  "command": "pcb_new",
  "params": {
    "project_name": "my_project"
  }
}

2. レスポンス形式：JSON 形式の結果パケット

{
  "status": "success",
  "result": {
    "project_path": "/path/to/my_project.kicad_pro"
  }
}

3. エラー処理：

{
  "status": "error",
  "message": "Failed to create project: Permission denied"
}

コマンド構造

コマンドは以下のカテゴリに分けられます：

プロジェクト管理

• project_new：新しいプロジェクトを作成
• project_open：既存のプロジェクトを開く
• project_save：現在のプロジェクトを保存
• project_close：プロジェクトを閉じる

PCB 設計

• board_size：基板サイズを設定
• add_layer：新しいレイヤーを追加
• remove_layer：指定されたレイヤーを削除
• set_layer_properties：レイヤー属性を変更

部品管理

• component_place：部品を配置
• components_array：部品を一括配置
• move_component：部品の位置を移動
• rotate_component：部品の方向を回転

配線機能

• route_trace：配線を追加
• add_via：ビアを追加
• create_differential_pair：差動ペアを作成
• set_net_class：ネットクラスを定義

🔧 技術詳細

サーバー側実装 (Node.js)

主なファイル：

• kicad-server.ts：MCP プロトコルのメインサービス
• command_handler.ts：コマンド処理センター

機能モジュール：

• コマンド解析とルーティング
• エラー処理メカニズム
• 接続状態管理

クライアント側実装 (Python)

主なファイル：

• kicad_interface.py：インターフェースアダプター
• 各コマンド処理モジュール (project.py, board.py, etc.)

💻 使用例

基本的な使用法

新しいプロジェクトを作成する

import kicad_interface as ki

result = ki.project_new("my_project")
print(result)
# 出力: {'status': 'success', 'project_path': '/path/to/my_project.kicad_pro'}

部品を配置する

result = ki.component_place(
    component_id="C1",
    footprint="DIP-8",
    position=(50, 60)
)
print(result)
# 出力: {'status': 'success', 'message': 'Component placed successfully'}

📚 ドキュメント

トラブルシューティング

一般的な問題

1. プロジェクトの作成に失敗する

   • 権限設定を確認する
   • ディスク容量が十分かを確認する

2. 部品を配置できない

   • 部品ライブラリのパスを確認する
   • フットプリントの定義を確認する

3. 配線エラー

   • 設計ルールチェック (DRC) を確認する
   • レイヤー設定が正しいことを確認する

開発ガイド

コントリビューションガイド

コミュニティからのコード貢献を歓迎します：

• ISSUE を提出して問題を報告する
• リポジトリを Fork して開発を行う
• Pull Request を作成する

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は以下の通りです：

MIT License

Copyright (c) 2023 KiCAD-MCP 開発チーム

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

連絡先

• プロジェクトの公式サイト：https://github.com/kiCad-MCP
• メールでの連絡：support@kicad-mcp.org
• ディスカッションフォーラム：Discussions Page