PlatformIO — MCP-сервер для Claude Code: что делает и как установить
Подключает инструменты PlatformIO к ИИ-агентам для сборки прошивок, прошивки плат и разбора логов. Пригодится при разработке встраиваемых систем на микроконтроллерах.
claude mcp add --env PLATFORMIO_MCP_POLICY=<PLATFORMIO_MCP_POLICY> --env PLATFORMIO_MCP_PROJECT_DIR=<PLATFORMIO_MCP_PROJECT_DIR> --env PLATFORMIO_MCP_PIO=<PLATFORMIO_MCP_PIO> --transport stdio platformio -- uvx platformio.mcpЧто делает PlatformIO
Сервер открывает агенту 40 инструментов для работы с микроконтроллерами. Модель сама инициализирует проект и запускает сборку через pio_build. При ошибках компиляции агент сразу видит проблемный файл и номер строки. Доступны прошивка по кабелю или через OTA, тесты Unity и статический анализ кода.
Вместо сотен килобайт сырых логов агент получает структурированный вердикт. Функция pio_flash_and_verify контролирует запуск платы через serial-порт и разбирает ошибки паники ядра ESP32. Сервер сверяет таблицы разделов памяти и показывает точное распределение байтов в ОЗУ.
Для работы необходимы Python 3.12 и утилита uv. Локальный бинарник pio сервер находит сам в путях системы или директории ~/.platformio/penv. Если PlatformIO Core ещё не установлен на машине, его можно подтянуть автоматически флагом --with-platformio.
Какие задачи решает
- собрать прошивку и выявить ошибки компиляции с точностью до строки
- прошить плату по USB или через OTA с проверкой успешного старта
- декодировать адреса паники ядра ESP32 в конкретные файлы проекта
- проверить таблицу разделов памяти и свободное место во флеше
- запустить компонентные тесты Unity на физическом железе
Примеры запросов агенту
- Собери окружение для платы esp32dev и покажи ошибки компиляции
- Зашей прошивку в микроконтроллер и проверь вывод в serial-порт до строки setup done
- Расшифруй адреса из лога паники ядра и найди упавшую строчку в файле
Как установить PlatformIO
Командой платформы
claude mcp add --env PLATFORMIO_MCP_POLICY=<PLATFORMIO_MCP_POLICY> --env PLATFORMIO_MCP_PROJECT_DIR=<PLATFORMIO_MCP_PROJECT_DIR> --env PLATFORMIO_MCP_PIO=<PLATFORMIO_MCP_PIO> --transport stdio platformio -- uvx platformio.mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from platformio.mcp <команда>
Командой платформы
codex mcp add platformio --env PLATFORMIO_MCP_POLICY=<PLATFORMIO_MCP_POLICY> --env PLATFORMIO_MCP_PROJECT_DIR=<PLATFORMIO_MCP_PROJECT_DIR> --env PLATFORMIO_MCP_PIO=<PLATFORMIO_MCP_PIO> -- uvx platformio.mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from platformio.mcp <команда>
Файл настроек
{
"mcpServers": {
"platformio": {
"command": "uvx",
"args": [
"platformio.mcp"
],
"env": {
"PLATFORMIO_MCP_POLICY": "<PLATFORMIO_MCP_POLICY>",
"PLATFORMIO_MCP_PROJECT_DIR": "<PLATFORMIO_MCP_PROJECT_DIR>",
"PLATFORMIO_MCP_PIO": "<PLATFORMIO_MCP_PIO>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from platformio.mcp <команда>
Файл настроек
{
"servers": {
"platformio": {
"type": "stdio",
"command": "uvx",
"args": [
"platformio.mcp"
],
"env": {
"PLATFORMIO_MCP_POLICY": "<PLATFORMIO_MCP_POLICY>",
"PLATFORMIO_MCP_PROJECT_DIR": "<PLATFORMIO_MCP_PROJECT_DIR>",
"PLATFORMIO_MCP_PIO": "<PLATFORMIO_MCP_PIO>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from platformio.mcp <команда>
Командой платформы
gemini mcp add -e PLATFORMIO_MCP_POLICY=<PLATFORMIO_MCP_POLICY> -e PLATFORMIO_MCP_PROJECT_DIR=<PLATFORMIO_MCP_PROJECT_DIR> -e PLATFORMIO_MCP_PIO=<PLATFORMIO_MCP_PIO> platformio uvx platformio.mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from platformio.mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о PlatformIO
Как установить PlatformIO в Claude Code?
Выполните в терминале команду claude mcp add platformio-mcp -- uvx platformio.mcp. Для работы требуются uv и Python 3.12.
Что делает MCP-сервер PlatformIO?
Он предоставляет ИИ-агентам 40 функций для разработки под микроконтроллеры. Агент может компилировать код, прошивать чипы, читать serial-порт и разбирать дампы памяти.
Что делать, если PlatformIO Core не установлен в системе?
Запустите команду установки с дополнительным флагом --with-platformio, чтобы сервер установил PlatformIO Core сам. Либо задайте путь к исполняемому файлу через переменную окружения PLATFORMIO_MCP_PIO.
