Arduino MCP Server — MCP-сервер для Claude Code
MCP-сервер связывает ИИ-агента с Arduino: помогает находить платы, собирать и загружать скетчи, читать Serial и проверять безопасность распиновки.
claude mcp add --env ARDUINO_CLI_PATH=<ARDUINO_CLI_PATH> --env ARDUINO_SKETCH_ROOT=<ARDUINO_SKETCH_ROOT> --transport stdio arduino-mcp-server -- npx -y arduino-mcp-serverЧто делает Arduino MCP Server
Arduino MCP Server оборачивает arduino-cli в MCP-интерфейс. Агент может обнаружить подключённые платы и порты, проверить ядра, собрать скетч, загрузить его на плату и дождаться сигнала готовности. Для Serial предусмотрены состояния с открытием, чтением, ожиданием шаблона, записью и закрытием.
Сервер также даёт справку по платам и запускает safety_preflight перед операциями с железом. Проверки учитывают опасные GPIO ESP32, контакты SPI flash, загрузочные пины, входы без встроенной подтяжки и параметры батареи. Без arduino-cli в PATH настройка зависит от его установки сервером или от заданного ARDUINO_CLI_PATH.
В конфигурации можно задать ARDUINO_SKETCH_ROOT, чтобы ограничить каталог скетчей. Для работы пакета нужен Node.js 20+; подключение к Claude Code выполняется через npx.
Какие задачи решает
- обнаружить подключённую Arduino-плату и её порт
- собрать скетч под выбранную плату
- загрузить прошивку без ручного запуска терминала
- читать и проверять сообщения Serial
- проверить распиновку и параметры батареи перед запуском
Примеры запросов агенту
- Проверь установку
arduino-cli, настрой окружение для Arduino Uno и найди подключённую плату. - Собери скетч
Blinkи загрузи его на Arduino Uno через найденный порт. - Открой Serial на скорости
115200и жди, пока устройство напечатаетREADY; перед записью выполни проверку безопасности.
Как установить Arduino MCP Server
Командой платформы
claude mcp add --env ARDUINO_CLI_PATH=<ARDUINO_CLI_PATH> --env ARDUINO_SKETCH_ROOT=<ARDUINO_SKETCH_ROOT> --transport stdio arduino-mcp-server -- npx -y arduino-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add arduino-mcp-server --env ARDUINO_CLI_PATH=<ARDUINO_CLI_PATH> --env ARDUINO_SKETCH_ROOT=<ARDUINO_SKETCH_ROOT> -- npx -y arduino-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"arduino-mcp-server": {
"command": "npx",
"args": [
"-y",
"arduino-mcp-server"
],
"env": {
"ARDUINO_CLI_PATH": "<ARDUINO_CLI_PATH>",
"ARDUINO_SKETCH_ROOT": "<ARDUINO_SKETCH_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"arduino-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"arduino-mcp-server"
],
"env": {
"ARDUINO_CLI_PATH": "<ARDUINO_CLI_PATH>",
"ARDUINO_SKETCH_ROOT": "<ARDUINO_SKETCH_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ARDUINO_CLI_PATH=<ARDUINO_CLI_PATH> -e ARDUINO_SKETCH_ROOT=<ARDUINO_SKETCH_ROOT> arduino-mcp-server npx -y arduino-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Arduino MCP Server
Как установить Arduino MCP Server в Claude Code?
Выполните claude mcp add arduino-mcp-server -- npx -y arduino-mcp-server.
Что делает Arduino MCP Server?
Он даёт агенту инструменты для обнаружения плат, компиляции и загрузки скетчей, работы с Serial и проверки электрических рисков.
Что нужно для работы Arduino MCP Server?
Нужен Node.js 20+ и arduino-cli в PATH, либо путь к CLI через ARDUINO_CLI_PATH. Каталог скетчей можно ограничить переменной ARDUINO_SKETCH_ROOT.
