Arduino MCP Server

io.github.akshatnerella由 GitHub 账号 akshatnerella 发布v0.2.7更新于 Nov 10, 2026

Arduino MCP server for CLI setup, board detection, compile/upload, serial monitoring, and pin refs.

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

让 AI 助手操控 Arduino 硬件：检测开发板、编译并上传草图、监控串口输出，并执行电气安全检查。

可以做什么
封装 arduino-cli，使助手能够检测已连接的开发板与串口、推断开发板 FQBN、安装板级核心、编译草图并上传到设备。它还提供有状态的串口会话（打开、读取、等待、写入、关闭）以及一次性读取，并在硬件操作前通过安全检查核对引脚电压与电流。参考类工具提供引脚与能力数据，提示词可引导 CLI 环境搭建。
适用场景
当你希望助手在不切换终端的情况下构建、烧录和调试 Arduino 草图，或在嵌入式开发中查看串口输出与引脚信息时使用。它是仅限桌面的本地服务器，适合连接了开发板的工作站。
运行要求
通过 stdio 在本地运行，从 npm 包 arduino-mcp-server 安装（需要 Node.js）。需要 arduino-cli 位于 PATH，或通过 ARDUINO_CLI_PATH 指定路径；服务器也可引导安装。ARDUINO_SKETCH_ROOT 可选，用于把草图操作限制在某个目录。上传与监控需要已连接的开发板和串口。
安装前请注意
它会写入硬件：upload_sketch 与 upload_and_wait_ready 会烧录固件，serial_write 会向设备发送数据，可能影响所连电路。safety_preflight 只是提示性检查，并非保证。设置 ARDUINO_SKETCH_ROOT 可限制可访问的草图路径，不设置则文件访问范围更大。不要求任何凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Arduino MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

arduino-mcp-server

[npm version] [License: MIT] [Node.js 20+]

Give your AI assistant full control over Arduino — compile, upload, monitor serial, and verify wiring safety, all through natural language.

Part of the HardwareMCP ecosystem — open-source MCP servers that bridge AI to physical hardware.

What this does

AI assistants can control Jira, GitHub, and databases. They can't talk to a microcontroller — until now.

arduino-mcp-server wraps arduino-cli into an MCP server so your AI can:

  • Detect connected boards and ports automatically
  • Compile and upload sketches without touching the terminal
  • Monitor serial output with stateful sessions (open, read, expect, write, close)
  • Run electrical safety checks before sending commands to hardware
  • Manage dependencies — cores, libraries, and CLI installation

Quick Start

Install:

bash
npm install -g arduino-mcp-server

Add to Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "arduino": {      "command": "npx",      "args": ["-y", "arduino-mcp-server"],      "env": {        "ARDUINO_CLI_PATH": "arduino-cli",        "ARDUINO_SKETCH_ROOT": "/path/to/your/sketches"      }    }  }}

Requires arduino-cli on your PATH, or let the server install it for you.

What you can say

Bootstrap from scratch:

"Check if Arduino CLI is installed and set everything up for an Arduino Uno."

Compile and upload:

"Compile my Blink sketch and upload it to the Uno on COM6."

Serial monitoring:

"Open serial on COM6 at 115200 and wait until the device prints READY."

Safety-first workflows:

"Run a safety preflight for an Arduino Uno with 5V on pin 13 at 25mA before I send commands."

Tools

ToolWhat it does
arduino_cli_doctorCheck Arduino CLI installation and version
install_arduino_cliGuide through arduino-cli installation
detect_hardwareDetect connected boards and infer FQBNs
list_connected_boardsList all connected Arduino boards
list_serial_portsList available serial ports
ensure_core_installedCheck/install board cores
compile_sketchCompile a sketch for a target board
upload_sketchUpload compiled sketch to a board
upload_and_wait_readyUpload and wait for device ready signal
serial_open_sessionOpen a stateful serial session
serial_readRead buffered serial data
serial_expectWait for a pattern in serial output
serial_writeSend data over serial
serial_close_sessionClose a serial session
serial_list_sessionsList active serial sessions
read_serial_snapshotQuick one-shot serial read
safety_preflightElectrical safety check before hardware ops
get_board_detailsGet pin/capability details for a board
list_supported_boardsList all boards arduino-cli supports
list_board_referenceBrowse board pin reference
search_board_referenceSearch board reference by keyword

Resources:

  • arduino://boards/reference — structured board pin/capability reference

Prompts:

  • arduino-cli-bootstrap-policy — policy for arduino-cli setup behavior
  • arduino-setup-assistant — guided Arduino environment setup

Configuration

VariableDefaultDescription
ARDUINO_CLI_PATHarduino-cliPath to arduino-cli binary
ARDUINO_SKETCH_ROOT(none)Restrict sketch paths to this directory

Development

bash
git clone https://github.com/hardware-mcp/arduino-mcp-servercd arduino-mcp-servernpm installnpm run typechecknpm run buildnpm run dev

Part of HardwareMCP

This server is part of the HardwareMCP ecosystem — a collection of MCP servers that give AI assistants real control over physical hardware.

License

MIT — see LICENSE.

Support

Open an issue

来源：README.md，提交 37ea038

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.7最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分