KiCad MCPサーバー統合

「KiCad」MCPサーバーは何をするのか？

KiCad MCP（Model Context Protocol）サーバーは、AIアシスタントとKiCad電子設計自動化スイートを橋渡しするためのツールです。ミドルウェアとして動作し、AIクライアントがmacOS、Windows、Linux上のKiCadプロジェクトデータ・ファイル・リソースにアクセスし操作できるようにします。この統合により、プロジェクトの発見、ファイル閲覧、コンテキスト共有などのタスクをLLM搭載アシスタント経由で直接実行できるため、ハードウェア・PCB開発ワークフローが強化されます。KiCad MCPサーバーは自然言語クエリをサポートしており、開発者やエンジニアがKiCadプロジェクトを管理・アクセス・検索しやすくなり、複雑なPCB設計作業の効率化が図れます。

プロンプト一覧

リポジトリやドキュメントには特定のプロンプトテンプレートは記載されていません。

リソース一覧

• KiCadプロジェクトディレクトリ
  • ユーザーが指定したKiCadプロジェクトを含むディレクトリへのアクセスを提供します。
• PCB設計ファイル
  • .kicad_pcbおよび関連するプロジェクトファイルをLLM参照用に公開します。
• プロジェクトメタデータ
  • プロジェクト名、パス、更新日時などのメタデータをコンテキストクエリ用に利用可能にします。

ツール一覧

リソースアクセス以外の明示的なツールは、ドキュメントやサーバーコードに記載がありません。リポジトリにもツール定義は見つかりません。

このMCPサーバーのユースケース

• プロジェクト発見と検索
  開発者はAIアシスタントに指定ディレクトリ内の全KiCadプロジェクトの検索・一覧を依頼でき、複数のハードウェアプロジェクト管理の効率が向上します。
• ファイル閲覧とアクセス
  AIクライアントはKiCadのPCBや回路図ファイルをブラウズ・オープン・参照でき、複雑な基板設計のレビューや編集作業がスムーズになります。
• LLMへのコンテキスト共有
  LLMが設計ディスカッションやトラブルシューティング時に、特定のKiCadプロジェクトファイルやメタデータをコンテキストとして利用できます。
• MCPクライアントとの統合
  Claude Desktopなどのツールとシームレスに統合でき、サマリー生成やプロジェクトインサイト抽出などの自動化ワークフローが実現します。
• クロスプラットフォームPCBコラボレーション
  Mac、Windows、Linux間でチームが共有プロジェクトリポジトリにアクセスでき、協働によるハードウェア開発を促進します。

セットアップ手順

Windsurf

リポジトリ内に明示的なWindsurf手順はありません。一般的なMCPセットアップが適用されます。

Claude

1. 必要条件の確認: Python 3.10+、KiCad 9.0+、Claude Desktopがインストールされていること。
2. リポジトリをクローンし、Python仮想環境をセットアップします。
3. pip install -r requirements.txt で依存関係をインストール。
4. ~Library/Application Support/Claude/claude_desktop_config.json を編集または作成します。
5. KiCad MCPサーバー設定を追加します:

{
  "mcpServers": {
    "kicad": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py"
      ]
    }
  }
}

6. Claude Desktopを再起動して設定を有効化します。

Cursor

リポジトリ内に明示的なCursor手順はありません。一般的なMCP JSON設定が適用されます。

Cline

リポジトリ内に明示的なCline手順はありません。一般的なMCP JSON設定が適用されます。

APIキーの保護について
機密パスや認証情報は.envファイル内の環境変数として管理してください。例:

KICAD_SEARCH_PATHS=~/pcb,~/Electronics,~/Projects/KiCad

JSON設定例（envおよびinputsの場合）:

{
  "mcpServers": {
    "kicad": {
      "command": "...",
      "args": ["..."],
      "env": {
        "KICAD_SEARCH_PATHS": "~/pcb,~/Electronics"
      },
      "inputs": {}
    }
  }
}

このMCPをフロー内で使うには

FlowHuntでのMCP利用方法

FlowHuntワークフローにMCPサーバーを組み込むには、まずMCPコンポーネントをフローに追加し、AIエージェントに接続します。

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションで、下記のJSON形式を使ってMCPサーバーの詳細を入力します。

{
  "kicad": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AIエージェントがこのMCPの全機能へアクセス可能なツールとして利用できるようになります。“kicad"は実際のMCPサーバー名に、URLはご自身のMCPサーバーのURLに置き換えてください。

概要

所感

このMCPサーバーはKiCadとLLMクライアント間の基礎的な統合を実現し、リソース共有やプロジェクト発見に特化していますが、より成熟したMCPサーバーに見られる高度なプロンプトやツールのカスタマイズ機能はありません。セットアップ手順は明確ですが、開発者向け機能は最小限です。

MCPスコア

上記テーブルをもとに、このMCPサーバーの評価は4/10です。インストールは簡単でニッチに有用ですが、拡張性やツール・プロンプト・サンプリングサポートといった成熟したMCP機能には欠けます。