kicad-mcp-pro

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

サーバーは現在、制限されたdefaultプロファイルで起動します。完全な377ツールのエキスパートカタログではなく、24の読み取り専用レビューツールを提供します。編集を制御するには書き込みモードのbuild、人間による承認を必要とする製造モードのrelease、または高度な信頼できるクライアント向けのexpert/fullを使用してください。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のプログラム可能なサーフェスのどの部分を駆動するかは、機能パリティマトリックスで公開されています。

Related MCP server: KiCad MCP Server

プロジェクトID

クイックスタート

デスクトップアプリ

最新のインストーラーを 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

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.3％）。真の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-Protocol-Version: 2025-11-25

• KICAD_MCP_STATEFUL_HTTP=1の場合、後続リクエストでMCP-Session-Id

デフォルトではStreamable HTTPはステートレスであるため、ChatGPTスタイルのコネクタはセッションヘッダーインジェクションプロキシなしで初期化し、tools/listを呼び出すことができます。KICAD_MCP_STATEFUL_HTTP=1を設定すると、initialize後にセッションIDが必要になります。

非推奨の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機能モードについては、 再現可能ブートストラップガイドを参照してください。

パッケージメタデータ

正規のメタデータ入力は、パッケージバージョンとリポジトリIDの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サーバーツールと同期された状態を維持します。

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

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. kicad-mcp-pro を stdio または Streamable HTTP 経由で起動または接続できること。

3. kicad_get_server_info または kicad_get_project_info を呼び出せること。

4. skills/ からスキルを読み込み、不足しているツールを参照せずにワークフローを実行できること。

5. ERC、DRC、DFM、エクスポート成果物、前提条件、および人間によるレビュー要件を個別に報告できること。

KiCad MCP Pro はエンジニアリングアシスタントであり、自律的な製造承認権限ではありません。生成された PCB および製造出力は、製造または組み立ての前に資格のある人間によるレビューが必要です。

開発

新しいコントリビューターは ARCHITECTURE.md から始めてください。このドキュメントは5つのレイヤー（トランスポート → MCP プロトコル → オーケストレーション → KiCad アダプターシーム → 純粋ドメイン）をマッピングし、新しいツールを追加する方法を正確に示しています。ランタイムモデルと品質ゲートスタックは 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 local git hooks

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

コントリビューション

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

このソフトウェアの引用

研究または技術出版物で 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 ライセンス の下で利用可能です。