PIO Agent (PlatformIO MCP)
PIO Agent собирает, прошивает и проверяет платы PlatformIO из агента через CLI pio-agent или MCP-сервер
- 54 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент прошивает реальное оборудование и открывает последовательные порты компьютера
- Неудачная прошивка может вывести плату из строя
Установка
- Работает в
Ручная установка
npm install -g platformio-mcpЗатем `pio-agent devices` и `pio-agent build --project-dir . --json`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент прошивает реальное оборудование и открывает последовательные порты компьютера
- Неудачная прошивка может вывести плату из строя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PIO Agent — слой выполнения для встраиваемой разработки на базе PlatformIO. В проект входят рантайм MCP, CLI `pio-agent` и необязательная локальная панель наблюдения. Команды покрывают поиск плат и устройств, подготовку проекта, сборку, прошивку, мониторинг порта, диагностику и оркестрацию задач. Для агентов есть проверки готовности проекта, разбор ошибок сборки по типам, аудит безопасных выводов GPIO, цикл прошивки с мониторингом и проверками на лету, отчеты о плате и привязка к проекту, окружению и устройству. CLI считается основным способом: после `pio-agent build --json` ничего не остается запущенным, MCP остается как вариант. Есть плагин для Codex и навыки, например `pio-manager`.
Для кого. Разработчикам встраиваемых систем на PlatformIO, которые хотят, чтобы агент собирал и прошивал платы и разбирал сбои.
Подходит, если
- Агент собирает проект и разбирает ошибку компиляции по типу с подсказкой исправления
- Проверяются выводы GPIO на конфликты и небезопасные режимы до прошивки
- Плата прошивается, а монитор порта проверяет выполнение утверждений
- Нужные плата, окружение и устройство определяются без ручного выбора
Не подходит, если
- К компьютеру не подключена плата и PlatformIO не установлен
- Прошивку нельзя доверять агенту без контроля
- Проект не на PlatformIO
Пример запроса к агенту
Собери проект для ESP32, проверь выводы GPIO на безопасность и прошей плату с проверкой по монитору портаMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Node.js и PlatformIO. Основной путь: `npm install -g platformio-mcp`, затем команды `pio-agent devices` и `pio-agent build --project-dir . --json`. Для MCP добавьте запись командой `claude mcp add platformio -- node /путь/к/platformio-mcp/build/index.js`, каждая сессия запускает свой процесс сервера. Агент прошивает реальное оборудование и открывает последовательные порты, поэтому прошивку лучше подтверждать вручную. Часть пакетов версии 3.2.0 описана как кандидат на публикацию, в документации приведены статусы каждого имени пакета.
Как отключить. Удалите пакет командой `npm uninstall -g platformio-mcp` и уберите запись `platformio` из конфигурации клиента.
Частые вопросы
Как поставить PIO Agent?
Выполните `npm install -g platformio-mcp`, затем проверьте `pio-agent devices` и соберите проект `pio-agent build --project-dir . --json`.
Что лучше, CLI или MCP?
Главным путем считается CLI: между командами ничего не запущено, клиенту нужен только бинарь `pio-agent`. MCP остается для клиентов, которые его предпочитают.
Как подключить MCP-сервер?
Выполните `claude mcp add platformio -- node /path/to/platformio-mcp/build/index.js`. Для Codex есть `npx platformio-mcp install --codex` и полный плагин.
Что проверяет аудит GPIO?
Инструмент `agent_safe_pin_audit` проверяет выводы с учетом конкретной платы на небезопасные назначения до прошивки.
Почему название PlatformIO MCP, а продукт PIO Agent?
PIO Agent называется продукт и плагин Codex, а PlatformIO MCP остается идентичностью рантайма для существующих установок, ключей конфигурации и совместимости.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер превращает GitHub Projects v2 в очередь задач для агентов: они берут работу, отчитываются и тратят бюджет токенов.
Pi 1C Agent: профиль 1С для Pi Coding Agent
Pi 1C Agent
Профиль для Pi Coding Agent под 1С-разработку: режимы ASK, PLAN и BUILD, специализированные субагенты, знания конфигурации и опциональные MCP-инструменты
Терминальный кодовый агент на Go и Google ADK: несколько провайдеров моделей, субагенты, LSP, память, MCP и скиллы.
APM
APM (Agent Package Manager)
Менеджер пакетов для контекста AI-агентов: скиллы, промпты и MCP-серверы ставятся одной командой во все поддерживаемые агенты
MCP-сервер и CLI на Go: агент ведет в репозитории индекс кода и схемы базы, хранит его в Git и читает целиком перед каждой задачей
MCP-сервер индексирует код через tree-sitter: агент читает отдельные символы вместо файлов, находит пути, оценивает влияние правок
Коротко о README
README представляет PIO Agent как слой выполнения для встраиваемой разработки, объясняет двойное название и статус релизов. Дальше идут быстрый старт через CLI, подключение MCP, возможности для агентов и документация по пакетам.