mpftp

mpftp — board tools for the editor, CLI, and agents.

mpftp Connect MicroPython and CircuitPython boards from VS Code, Cursor, or the CLI: dual-pane file transfer, in-editor REPL, firmware flash, mip/circup, plus RPC, MCP, and an optional browser PWA.

GitHub Repo User Guide Agent guide Integrations
Live Pure-Python Device

Editor session

Dual-pane file transfer beside a live serial REPL — same board session as the CLI and MCP tools.
mpftp — COM4 (MicroPython)

Dual-pane file transfer

Local workspace           Board
------------------        ----------------
main.py                   /boot.py
board_config.py           /main.py
lib/pydevices/            /lib/pydevices/
  displaydev.py             displaydev.mpy
  audiodev.py               audiodev.mpy

REPL & firmware

>>> import board_config
>>> board_config.display_drv.fill(0xF800)
>>> print("PyDevices OK")
PyDevices OK
>>>
$ mpftp firmware flash
[FLASHER] Writing image... 100%

Surfaces

VS Code / Cursor extension

Connect, dual-pane files, in-editor REPL, mip/circup, and a visual firmware builder — without leaving the editor.

CLI & agent RPC

python -m mpftp shares the active editor session. Agents use the CLI or a local TCP RPC; see the agent guide.

MCP & integrations

Typed board tools for Claude Code and Codex, plus a Claude Desktop extension — same port, files, and REPL as the UI.

Optional browser PWA

No editor required: pip install -i https://test.pypi.org/simple/ pydevices-mpftp && python -m mpftp opens file transfer and REPL in a local browser tab. (In the published 0.0.3 package the PWA is not yet included — run from a clone until the next release.)