用文字描述一塊電路板,再讓 AI 選元件、畫電路圖、擺放與佈線,已經有工具能把這條流程接起來,HeyPCB MCP讓 Claude Code 等 Agent 呼叫電路設計服務,最後輸出可在 KiCad 開啟的工程檔,後續還能繼續修改。
它最有用的地方,是讓工程師能用需求和檢查結果反覆調整設計。
需要先理解的則是:HeyPCB 的主要設計工作在雲端服務執行,本機 MCP 套件負責連接與檔案整合,拿到工程檔、通過規則檢查,以及做出可靠的實體電路板,是不同階段。
內容目錄
HeyPCB MCP 做了什麼?Agent 提需求,設計服務完成工程工作
官方 GitHub列出兩種使用方式。第一種由 HeyPCB 的設計 Agent Inky 處理整體設計,你的 Agent 主要呼叫 build_board、get_board、check_board 與 export。第二種則由你的 Agent 逐步選零件、接線、移動元件和設定板規,透過工具控制更細的步驟。
這裡的 MCP 是模型與工具之間的介面。模型能理解需求,還需要 Agent 把需求轉成有效的工具參數,並讀懂回傳結果。若想釐清工具呼叫與 MCP 的分工,可以對照模型工具呼叫與 Agent 整合的差別,不是換一顆模型就自動獲得完整電路設計能力。
RGB 燈板案例:真正有意思的是反覆修正
在官方展示案例中,Claude Code 透過 HeyPCB 建立 RGB 點陣燈板,完成電路圖、元件擺放、雙層板佈線與接地鋪銅。
第一版的 LED 排列和模組位置不合適,接著又調整網格、把支援元件移到背面,重新佈線。
其中一個連接仍然走不通,後來透過旋轉一顆 LED 再完成連線。
這比較能說明這類工具的價值:它可以讀取狀態、提出修改、重新檢查,而不是只生成一張看起來像電路板的圖片。
官方表示該案例也匯出到 KiCad,並通過 KiCad 的規則檢查。
先選連接方式:遠端 MCP 或本機橋接
| 方式 | 適合用途 | 資料與環境 |
|---|---|---|
| 遠端 MCP | 從需求新建專案,直接呼叫 HeyPCB 工具 | 透過 HTTPS 連到服務,使用瀏覽器登入 |
| 本機 MCP 套件 | 讀取 KiCad 專案資料夾、同步修改、把匯出結果存回本機 | 需要 Node.js,主要設計仍連到 HeyPCB |
| 本機 KiCad 檢查與匯出 | 對本機檔案跑 KiCad 的 DRC/ERC 或匯出 | 另需 KiCad 與 kicad-cli,這部分可在本機執行 |
如果只想在 Claude Code 建一個新專案,可以先用遠端方式,需要操作本機 KiCad 資料夾,再用本機套件,目前的客戶端說明也提醒,部分客戶端的遠端登入存在相容性限制,不能把一個客戶端連線成功當作其他環境都已驗證。
方法一:在 Claude Code 加入遠端 MCP
假設已安裝並能正常使用 Claude Code,在終端機執行:
claude mcp add --transport http heypcb https://api.heypcb.ai/mcp
重新開啟 Claude Code 的對話,透過 /mcp 檢查連線,依畫面完成 HeyPCB 的瀏覽器登入。
先確認能取得工具清單,再請 Agent 查詢帳號狀態與可用功能,暫時不用立刻啟動設計工作。
這條路不需要另裝本機 Node MCP 套件,但仍需要 HeyPCB 帳號與服務存取。
若帳號狀態或工具權限不符,應先處理連線,不能把登入失敗當成模型不會設計電路。
方法二:本機套件連接 KiCad 資料夾
本機套件要求 Node.js 18 以上。先從Node.js 官方下載頁安裝適合系統的版本,再檢查 node、npm 和 npx 是否可用。下列命令固定查核時的套件版本,便於追溯。
node --version
npm --version
npx --version
npx -y @heypcb/[email protected] login
npx -y @heypcb/[email protected] status
claude mcp add heypcb -- npx -y @heypcb/[email protected]
這是另一種連接路線,與前面的遠端設定選一種即可,避免在同一個客戶端重複加入同名 heypcb,登入時核對瀏覽器頁面與終端機顯示的代碼,再完成連接。
本機套件以 stdio 方式由 Agent 啟動,單獨在終端機執行後等待,不一定是當機,登入資訊會保存於電腦上的 HeyPCB 設定目錄,文章與專案不需要放入這些憑證。
若要用 check_local 或 export_local,還要安裝 KiCad 8 或更新版本,確認 kicad-cli 可被找到,只有要開啟和編修匯出的工程,也可以先安裝 KiCad,再用圖形介面接續處理。
第一個需求要寫清楚什麼?先做小型設計
不要只說「幫我畫一塊好用的板子」,先交代用途、供電、主要元件、尺寸、接頭位置、層數與製作方式,再讓 Agent 列出缺少的資訊。
以下是一份需求結構示意,實際元件與電源條件仍要依資料表確認:
請先整理這個 PCB 專案的需求,不要直接開始付費設計。
用途:小型 RGB 指示燈控制板。
請先確認供電方式、控制器、LED 型號與數量、最大功耗,
再確認板子尺寸、接頭位置、固定孔和外殼限制。
列出仍需我決定的項目,並用 estimate 說明下一步預估費用。
完成設計後,請整理檢查結果與待人工確認項目,匯出 KiCad 工程。
需求確認後,再依任務選擇整板設計或逐步編修,每次改完重要位置、板框或佈線,都重新讀取目前狀態和檢查結果,不要只看最後一張 3D 預覽。
如果想先理解 ESP32 的韌體與實體裝置怎麼分工,可以參考ESP32-S3 開發板與韌體流程,自己畫 PCB 之後,還是需要與所選晶片、模組和實際周邊相容的韌體。
費用與上傳範圍,要在開始設計前看清楚
MCP 套件開源,不代表 HeyPCB 的工程服務全部免費,官方將整板設計、Inky 設計回合、部分檢查、擺放與佈線列為可能計費的工作,先用 estimate 看預估,並用 whoami 確認帳號和餘額。實際費率以服務當下顯示為準。
目前文件也明確說明,本機客戶端提供的花費上限,在伺服器尚未支援強制執行時,會直接拒絕可能計費的呼叫,不能把 --max-spend 理解成服務已經會自動做到指定金額才停,也不能把缺少費用回傳當成零成本。
使用 open_kicad_project 時,專案會綁定到 HeyPCB,變更後的設計檔也會再次上傳並同步。
這會送出你的電路設計,不是完全離線的本機編輯器。開始前先用副本測試,並檢查專案裡是否含有不應上傳的檔案。
官方提供 .heypcbignore 排除規則,也會在同步覆寫前備份舊檔。
若你在 KiCad 與雲端同時修改,可能出現衝突副本,需要決定採用哪一邊。
這類工作流很依賴工作目錄與工具權限的管理,和Agent 工作台的檔案與 MCP 管理是相同的基本觀念,不能只看聊天視窗是否回答成功。
匯出 KiCad 之後,怎麼接續驗收?
遠端 export 會回傳限時下載連結,本機套件的 save_export 則能把工程或製造資料存進指定資料夾,可以請 Agent 匯出 KiCad 專案,再用 KiCad 開啟電路圖與 PCB,確認兩者對應、元件和封裝沒有遺失。
- 先看 ERC 與 DRC 的錯誤、警告及未連接項目,逐項處理或寫明保留理由。
- 核對電源、接腳用途、封裝、元件方向、接頭位置與機構尺寸。
- 依實際製板廠的板規檢查線寬、間距、孔徑與層疊條件。
- 檢查韌體、啟動與燒錄路徑,以及實際使用時的功耗和散熱。
- 保留工程版本、元件清單和檢查紀錄,再安排打樣與量測。
KiCad 的 PCB 編輯器文件說明了板框、佈線、覆銅與規則檢查等功能。
DRC/ERC 是必要的設計檢查,但通過檢查不代表量產可靠性、訊號品質與功能都已被測過。外殼能輸出 3D 檔,也還要確認裝配公差、接頭開孔與散熱。
第一個練習可以從功能單純的小板開始,走完需求、設計、人工審查、匯出、打樣與測試。這樣才能知道 AI 幫你省下了哪些工作,又在哪些地方仍需要工程判斷。
FAQ
HeyPCB MCP 是完全離線的 KiCad 外掛嗎?
不是。主要設計工具連到 HeyPCB 雲端。本機套件提供專案上傳、同步及存檔整合,其中透過 kicad-cli 的本機檢查與匯出可在本機執行。
可以匯出後在 KiCad 繼續修改嗎?
可以。官方提供 KiCad 工程匯出,本機套件也能綁定既有專案資料夾同步修改。匯出後應確認電路圖、PCB、庫檔與封裝是否完整。
安裝開源 MCP 就能免費設計整塊板嗎?
不能這樣理解。部分設計、檢查、擺放與佈線工具可能計費,應先查看 estimate、帳號狀態與服務費率。
通過 DRC 和 ERC 就能直接量產嗎?
不能。這些檢查無法取代元件資料表核對、功能測試、電源與熱設計,以及實板打樣和量測。
需要在電腦安裝什麼?
遠端 MCP 需相容的 Agent 客戶端與 HeyPCB 登入。本機套件需 Node.js 18 以上,本機 KiCad 檢查與匯出則另需 KiCad 8 以上及可用的 kicad-cli。