Kicad Mcp Pro

KiCad MCP Pro は、KiCad EDA ワークフロー向けの Model Context Protocol サーバーです。回路図、PCB、検証、DFM、および製造用エクスポートを自動化するためのツール、リソース、プロンプトを提供します。

サーバーは、現在、範囲を限定した default プロファイルで起動します。完全なエキスパートカタログではなく、読み取り専用のレビュー用ツールを 24 個提供します。制御された編集には書き込みモードの build、人による承認を条件とした引き渡しには製造モードの release を使用してください。高度で信頼できるクライアントに限り、expert／full を使用してください。現在のカタログ件数とコンテキストサイズの推定値は、docs/evidence/progressive-disclosure-profile-snapshot.json に記載されています。詳しくは docs/agents/progressive-disclosure.md を参照してください。

テレメトリとエラー報告は、デフォルトで無効になっています。オプトイン形式の OpenTelemetry 設定については docs/configuration.md に記載されています。また、プライバシーに関する規則は docs/privacy.md に記載されています。

対象範囲と誠実性

KiCad MCP Pro は、プロフェッショナル向けの初期設計・レビューアシスタントであり、自動承認を行うものではありません。ERC/DRC とエクスポートパイプラインでは、KiCad 独自のエンジンが実行されます。シグナルインテグリティ、パワーインテグリティ、EMC、熱に関するツールは、一次近似による閉形式の推定（通常、精度は約 5～10％）です。初期レビューをすばやく行うためのものであり、2D/3D フィールドソルバー、EM/FEA シミュレーション、正式な承認の代替にはなりません。実際の部品調達には、デフォルトで JLCPCB の公開カタログを使用します。Nexar、DigiKey、Mouser は、API 認証情報を設定した場合にのみ利用できます。サーバーが KiCad のプログラムから利用可能な機能のうち、どの程度を操作できるかは、機能パリティマトリックスで公開しています。ツール数や機能カバレッジはインベントリの指標であり、製品品質を測る主要指標ではありません。エンドツーエンドのタスク結果、変更からの復旧、破損、必須の DRC 実行、製造の再現性が、成果を測る KPI です。コミット済みのnative-live の実例エビデンスでは、意図的に insufficient_evidence と報告しています。代表的なコーパスでの目標達成状況は、#730 の適格性評価作業が完了するまで、別途扱います。

プロジェクトの基本情報

項目	値
正式なリポジトリ	oaslananka/kicad-mcp-pro
PyPI パッケージ	kicad-mcp-pro
npm ラッパー	kicad-mcp-pro
MCP レジストリ名	io.github.oaslananka/kicad-mcp-pro
バージョン	4.4.0
OSS 成熟度レポート	docs/repo-maturity-report.md
OpenSSF エビデンス	docs/openssf-evidence.md

クイックスタート

デスクトップアプリ

最新のインストーラーをGitHub リリースページからダウンロードしてください。Tauri デスクトップアプリは Python ダッシュボードサーバーを自動的に起動し、http://127.0.0.1:3334/ui で GUI を開きます。デスクトップ版は、対応する正確なバージョンのバックエンドを起動し、使用前にデスクトップ互換性ハンドシェイクを検証します。詳しくはインストールをご覧ください。

CLI

uvx kicad-mcp-pro init
uvx kicad-mcp-pro tray
uvx kicad-mcp-pro dashboard --open
uvx kicad-mcp-pro --transport streamable-http --port 3334

KiCad PCB エディターコンパニオン（開発プレビュー）

既存の KiCad PCM Companion は、packages/kicad-plugin/ の KiCad 10 IPC ツールバープラグインへとアップグレード中です。アクティブな PCB を読み取り、既存のローカルダッシュボードへのリンクを表示します。IPC アップグレードは読み取り専用です。実機でのデスクトップ受け入れ確認とリリースは保留中です。

Web ダッシュボード

uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open
# http://127.0.0.1:3334/ui

ドキュメント

ドキュメントは、セットアップから運用まで順に構成されています。

1. インストール
2. クライアントの設定
3. ランタイムの設定
4. ツールリファレンス
5. ワークフロー
6. リリースプロセス
7. セキュリティとプライバシー
8. KiCad の機能パリティ — このサーバーが KiCad のプログラムから利用可能な機能のうち、どの程度を操作できるか
9. エラーコード一覧 — 安定したエラーコード、再試行の分類、復旧方法
10. 作業指示の監査 — 強化作業指示の現在の状況

kicad_capability_parity() ツールは、ワークフローの領域ごとに、このサーバーが KiCad のプログラムから利用可能な機能のうち、どの程度を操作できるかを報告します（現在 76.6%）。真の gap と、KiCad がヘッドレス API を提供していない gui-only-no-api 項目を区別しています。

公開ドキュメントサイトは、https://oaslananka.github.io/kicad-mcp-pro/ でご覧いただけます。

トランスポート

KiCad MCP Pro は stdio と Streamable HTTP に対応しています。Streamable HTTP はデフォルトで /mcp で提供され、KICAD_MCP_MOUNT_PATH で変更できます。

uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334

Streamable HTTP クライアントは Accept: application/json, text/event-stream と Content-Type: application/json を送信する必要があります。主要な公開 MCP コントラクトは 2026-07-28 です。最新のクライアントは MCP-Protocol-Version: 2026-07-28、 最終プロトコルで必要なメソッド名／トランスポートヘッダー、およびリクエストごとの クライアントメタデータエンベロープを送信します。

後方互換性のある 2025-11-25 クライアントも、SDK のレガシーな initialize ネゴシエーションを通じて引き続きサポートされます。これらの クライアントは後続のリクエストでネゴシエーション済みのプロトコルバージョンを エコーし、KICAD_MCP_STATEFUL_HTTP=1 の場合は MCP-Session-Id もエコーします。 最終版の 2026-07-28 の通信はステートレスで、MCP セッションを作成しません。

非推奨の HTTP+SSE フォールバックルートはデフォルトで無効になっています。 Streamable HTTP を使用できない古いクライアントに限り、 KICAD_MCP_LEGACY_SSE=1 を設定してください。

インストール

公開パッケージ：

uvx kicad-mcp-pro --help
npx kicad-mcp-pro --help

サポート対象の Linux ホストでの新規ソースチェックアウト：

./scripts/bootstrap-dev.sh
source .dev-env.sh
pnpm run dev:doctor -- --ci

リポジトリのブートストラップでは、チェックサムで固定された Python、uv/uvx、Node.js、 pnpm、Task、Rust のツールを無視対象となるチェックアウト内のルートにインストールし、 依存関係を固定してインストールします。グローバルなツールディレクトリは変更しません。 --core-only、--check、クリーンアップ、アップグレード、KiCad の機能モードについては、 再現可能なブートストラップガイドを参照してください。

パッケージメタデータ

正規のメタデータ入力元は、パッケージのバージョンとリポジトリの識別情報を記載した pyproject.toml と、KiCad および MCP のサポートポリシーを記載した compatibility.yaml です。server.json は生成されたレジストリマニフェストです。 pnpm run metadata:sync で公開用の各ファイルを生成し、 pnpm run metadata:check で CI とリリース検証時に内容を確認します。

使用方法

kicad-mcp-pro --help で CLI コマンドを確認し、 docs/client-configuration.md を参照して MCP クライアントを設定してください。生成されたツールカタログは docs/tools-reference.generated.md で確認できます。

エージェントプラグインとスキル

このリポジトリは、KiCad MCP Pro の製品レベルのエージェントプラグインと KiCad 固有のスキルを管理しています。中央の agent-tools リポジトリでこのプラグインをカタログ化する想定ですが、マニフェストとワークフローの手順は、実際の MCP サーバーツールとの同期を保つため、ここに置かれています。

ファイル	目的
.claude-plugin/plugin.json	対応するエージェントランタイムおよびマーケットプレイスカタログ向けの製品レベルのプラグインマニフェストです。
.mcp.json	Claude Code のプロジェクトローカル MCP サーバー設定です。
.codex/config.example.toml	Codex CLI の MCP 設定例です。
.vscode/mcp.example.json	VS Code / GitHub Copilot のワークスペース MCP 設定例です。
integrations/opencode/opencode.example.json	OpenCode のプロジェクト MCP 設定例です。
.opencode/skills/	OpenCode ネイティブ形式にミラーリングされたスキル定義です。
docs/agent-runtime-config.md	エージェントランタイムのセットアップと検証マトリクスです。
skills/kicad-design-review/SKILL.md	KiCad 設計を包括的にレビューするスキルです。
skills/pcb-design/SKILL.md	PCB 設計、レイアウト検査、部品配置、配線、スタックアップ、基板品質のワークフローです。
skills/drc-check/SKILL.md	ERC/DRC の実行、トリアージ、免除のレビュー、再検証のワークフローです。
skills/fabrication-output/SKILL.md	製造用データのエクスポート、DFM、リリースの証跡、製造パッケージのワークフローです。
skills/schematic-review/SKILL.md	回路図の検査、ERC、接続、電源、シンボル、読みやすさのワークフローです。

エージェントのセットアップ

KiCad MCP Pro は、公開済みの Python パッケージ、npm ラッパー、または server.json で宣言されたコンテナメタデータを使用して起動できます。一般的なローカルでの起動方法は次のとおりです。

uvx kicad-mcp-pro --transport stdio
uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334
npx kicad-mcp-pro --help

ソースをチェックアウトした場合は、プラグインの変更を公開する前に、通常のリポジトリ検証手順を実行してください。

corepack pnpm run metadata:check
python3 -m json.tool .claude-plugin/plugin.json >/dev/null

検証ワークフロー

このプラグインを agent-tools から有効なものとして掲載する前に、少なくとも1つの対応エージェントランタイムで、次のことができることを確認してください。

1. .claude-plugin/plugin.json を検出できる。
2. stdio または Streamable HTTP 経由で kicad-mcp-pro を起動または接続できる。
3. kicad_get_server_info または kicad_get_project_info を呼び出せる。
4. skills/ 内のスキルを読み込み、存在しないツールを参照せずにワークフローに従える。
5. ERC、DRC、DFM、エクスポート成果物、前提条件、人によるレビューが必要な項目をそれぞれ分けて報告できる。

KiCad MCP Pro はエンジニアリングアシスタントであり、製造の自律的な承認を行うものではありません。生成された PCB および製造用データは、製造または組み立ての前に、適切な資格を持つ人によるレビューが必要です。

開発

新しい貢献者は、5つのレイヤー（トランスポート → MCP プロトコル → オーケストレーション → KiCad アダプター境界 → 純粋なドメイン）を示し、新しいツールの追加方法を詳しく説明している ARCHITECTURE.md から読み始めてください。ランタイムモデルと品質ゲートの構成については、docs/development/architecture.md に記載されています。

このプロジェクトでは、一般的な開発コマンドに Taskfile.yml を使用します。リポジトリをクローンした後、次を実行してください。

task install     # Install all dependencies (pnpm + uv)
task verify      # Run the local quality gate: lint → format → typecheck → test → build
task test        # Run unit tests only
task lint        # Run lint and metadata checks
task format      # Auto-format the codebase
task typecheck   # Run strict static type checking
task build       # Build release artifacts
task ci          # Run the local equivalent of the full CI pipeline
task hooks       # Install repository-pinned Lefthook git hooks

すべての変更は、プルリクエストを作成する前に task verify に合格する必要があります。

貢献

プルリクエストを作成する前に CONTRIBUTING.md をお読みください。すべての変更は、リポジトリのフォーマット、リント、型チェック、テスト、ワークフロー、セキュリティ、パッケージメタデータに関する各ゲートに合格する必要があります。

独立した業界メディアの紹介

• JLCPCB（2026年10月14日） — KiCad MCP：Claude Code で PCB を設計する方法では、XL4015／LM358 降圧コンバーターの設計を例に、確認項目や制限事項を含む KiCad MCP Pro の実践的なワークフローを紹介しています。基板は製造もベンチテストもされていません。これは独立した紹介であり、JLCPCB による推奨や提携を示すものではありません。報告された問題は #1314 で評価中です。

このソフトウェアの引用

研究や技術出版物で KiCad MCP Pro を使用する場合は、DOI を使ってアーカイブされたリリースを引用してください（完全なメタデータについては CITATION.cff を参照）：

@software{aslan_kicad_mcp_pro,
  author  = {Aslan, Osman},
  title   = {KiCad MCP Pro},
  license = {MIT},
  url     = {https://github.com/oaslananka/kicad-mcp-pro},
  doi     = {10.5281/zenodo.21283791}
}

GitHub の各リリースは、このコンセプト DOI の下で Zenodo にアーカイブされており、常に最新バージョンに解決されます。

ライセンス

KiCad MCP Pro は MIT License の下で利用できます。