Kicad MCP

🚀 KiCad MCP

KiCad MCP 是將 MCP 集成到 KiCad 中的項目，歡迎提交問題和拉取請求。它為 KiCad 帶來了強大的 MCP 功能，提升了使用體驗。

✨ 主要特性

• 開箱即用的完整 MCP 支持
• 內置 KiCad MCP 服務器

🚀 快速開始

1. 下載軟件：下載 KiCad 華秋髮行版 9.0.7-rc3 ，你也可以在 GitHub 發佈頁面 找到便攜版。正式版本將隨 KiCad 10 一起發佈。
   • 安裝建議：使用安裝程序為用戶安裝，或者使用便攜版並解壓到可寫目錄。否則，在安裝 Python 包時，KiCad MCP 服務器可能會因缺少寫入權限而初始化失敗。
2. 打開面板：打開 PCB 或原理圖編輯器，點擊“機器人”按鈕以切換 Copilot 面板。
3. 配置設置：點擊設置（齒輪）按鈕，填寫 OpenAI API Key 和 OpenAI Endpoint。應該有一個現有的內置 KiCad MCP 服務器可用。

🔧 技術細節

KiCad MCP 客戶端

KiCad 客戶端通過嵌入 mcp-agent 具備了完整的 MCP 功能。KiCad 編輯器（PCB/原理圖）在啟動時會自動啟動一個 KiCad MCP 客戶端 實例，並將雙通信 IPC 通道和 KiCad IPC API URL 傳遞給它。

KiCad IPC API

KiCad IPC API 是 KiCad MCP 的核心，也是它與其他 MCP 客戶端的區別所在。我們計劃為其添加更多場景驅動的 API。如果你對開發 KiCad IPC API 感興趣，可以查看 KiCad 或 KiCad 華秋電子發行版 的源代碼。我們的分支始終與最新的 KiCad 發佈分支保持同步，所有上游更改都會合併到其中。

KiCad MCP 服務器

KiCad MCP 服務器 基於官方 MCP Python SDK 將 KiCad IPC API 作為 MCP 工具公開。目前有 72 個工具 可用，未來還會添加更多。

前端

我們在 我們的服務器 上託管了 NextChat 作為前端。它通過 WebView IPC API 與 KiCad 交互，而 KiCad 則在 UI 和 mcp-agent 之間轉發消息。

📦 安裝指南

KiCad IPC API

請遵循 官方 KiCad 開發指南。

KiCad MCP 服務器

1. 找到本地 KiCad MCP 服務器的安裝目錄。
2. 克隆倉庫並替換整個目錄。

cd /path/to/kicad-installation-directory # 如果為用戶安裝，則為 %LOCALAPPDATA%\Programs\KiCad\9.0\bin
rm -rf ./kicad-mcp-server
git clone https://github.com/Huaqiu-Electronics/kicad-mcp-server.git

別忘了提交你的更改並打開拉取請求。

📚 詳細文檔

KiCad MCP 工具為空

如果你發現 KiCad MCP 工具為空，請按照以下步驟修復：

1. 確保安裝目錄可寫。
2. 如果你為 Python pip 命令配置了鏡像源，請確保該鏡像源沒有封禁你的 IP。MCP SDK 在首次啟動時會拉取大量 Python 包。

啟用新添加的 MCP 服務器

新的 MCP 服務器默認是禁用的，你可以通過點擊輸入框中附件圖標旁邊的按鈕來檢查並啟用它們。