arduino-mcp

Arduino MCP Skill 為 AI 代理提供了與 Arduino IDE 2.0 專案互動的專門介面。透過模型上下文協定 (MCP)，它消除了自然語言指令與底層原始碼操作之間的差距，實現了嵌入式軟體的無縫開發。此技能專為希望自動化重複性程式碼任務、重構韌體或為微控制器專案實作持續整合工作流程的開發人員、教育工作者和愛好者所設計。

該工具協助進行完整的專案生命週期管理，從驗證專案結構到編譯二進位輸出。透過維護帶有 MCP stdio 傳輸的 REST API，它確保了與多種代理框架（如 Moltbot 或 Clawdbot）的相容性，同時將操作限制在定義的專案目錄內以確保安全。使用者可以與他們的 Arduino 草稿互動，以修改邏輯、增加偵錯語句或管理包含 .ino、.h、.cpp 或 .c 檔案的多檔案專案。

• 驗證 Arduino 草稿資料夾，確保符合 IDE 2.0 標準。

• 直接讀取與寫入原始碼檔案，預設功能針對主要的 .ino 檔案。

• 列出專案目錄內所有相關的原始碼檔案（標頭檔、C/C++ 原始碼），以提供全面的上下文。

• 使用外部 arduino-cli 工具觸發建置程序，支援自訂 FQBN（完整板型名稱）設定。

• 提供健康檢查與 RESTful 端點，便於與非 MCP 環境整合。

• 呼叫工具時務必指定 projectRoot 路徑，以確保操作僅限於目標草稿目錄。

• 變更應以漸進方式進行；為安全性考量，除非請求指定路徑，否則技能偏好修改主要的 .ino 檔案。

• 需要 Node.js 18+，編譯任務可選配安裝 arduino-cli。

• 環境變數（如 ARDUINO_FQBN 與 ARDUINO_API_PORT）可針對特定硬體目標或自訂埠需求進行設定。

• 非常適合涉及序列埠偵錯、函式庫整合或跨不同開發板（如 Nano、Uno 或 ESP 系列）的快速原型開發使用場景。