Repository navigation
v0.2.0
First GitHub release for platformio.mcp (0.1.0 was published to PyPI but never tagged here). Install with:
uvx platformio.mcp installAdded
- 11 new tools (40 total):
pio_upload_ota: flash over Wi-Fi to ArduinoOTA (espota) boards with a reachability pre-check and failures mapped to the fix.pio_port_diagnose: explain why a serial port cannot be used (our session, another process via lsof/fuser, permissions, board not answering).pio_partition_table: validate the ESP32 partition CSV (alignment, overlaps, flash fit, OTA slots, app fit) and, withread_device, diff it against the table on the chip.pio_coredump: read the core dump partition over esptool and decode it with the optionalesp-coredumpanalyzer.pio_memory_watch: heap and stack telemetry parsed from serial output with leak, fragmentation, and stack-headroom verdicts.pio_power_profile: current draw from a serial meter or a Nordic PPK2 with sleep/active split, energy, and battery estimate.pio_deps_check: library name collisions, unpinned specs, missing and leftover libraries, circular dependencies, and the LDF dependency graph.pio_debug_start/pio_debug_cmd/pio_debug_stop/pio_debug_list: live GDB sessions overpio debug --interface=gdbwith GDB/MI parsed into structured results.
stop_open_sessionsonpio_uploadandpio_run_targetreleases our own monitor sessions before flashing; upload failures now carryport_errorandport_diagnosis.- Optional extras
coredump(esp-coredump) andpower(ppk2-api). - Community files: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, issue forms, PR template, Dependabot config.
- Open Plugins layout (
.mcp.json,plugin.json,skills/platformio/SKILL.md,rules/platformio.mdc) so the repo installs as a Claude Code or Cursor plugin and lists on cursor.directory. bad_regexstructured error when await_for,until,expect,fail_on, orfilterpattern is not a valid regular expression.- Log pruning: the log directory keeps the newest 200 files (
PLATFORMIO_MCP_MAX_LOGSoverrides). server.jsonand the README ownership marker for the official MCP Registry.- GitHub Actions CI on Linux, macOS, and Windows, plus an integration job that builds the native fixture with real PlatformIO.
Fixed
- Toolchain prefix derivation kept the caller's path separator, fixing
pio_decode_backtraceandpio_size_reporton Windows. - Any unexpected exception inside a tool now returns
ok: falsewith the exception text instead of a bare "Error executing tool".
Security
- Raised the
mcpfloor from>=1.0to>=2.2. The old floor let scanners resolve to SDK releases affected by CVE-2025-53365, CVE-2025-53366, CVE-2025-66416, CVE-2026-52869, and CVE-2026-59950 (all fixed by mcp 1.28.1). The server already required the 2.x API, so no behaviour changes.