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 系列）的快速原型开发使用场景。