meshtastic/meshtastic-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP server + agent skills for AI tooling to discover, drive, observe, and test Meshtastic devices and apps
개요
A home for AI tooling to Meshtastic devices and the apps that talk to them. An MCP server plus a bundled agent skill set for closed-loop device ↔ app end-to-end testing. Extracted and decoupled from the Meshtastic firmware repo's mcp-server/ so it can be installed and distributed on its own. The firmware-build tools become an optional capability that lights up only when a firmware checkout is present. Inside Claude Code (or any MCP client registered with meshtastic): No firmware checkout required. Core tools work against any serial or TCP device. install edits the client's mcpServers JSON in place (preserving other entries) — it picks the right config path per --client (claude-code / claude-desktop / cursor / windsurf) and --scope (user / project), or pass --config PATH. Add capability env vars with --env KEY=VALUE. Restart the MCP client to pick up the change. The MCP client keeps running the old server until you restart it.
README
원문 README의 일부입니다. 원문 보기.
meshtastic-mcp
A home for AI tooling to discover, drive, observe, and test Meshtastic devices and the apps that talk to them. An MCP server plus a bundled agent skill set for closed-loop device ↔ app end-to-end testing.
Extracted and decoupled from the Meshtastic firmware repo’s
mcp-server/so it can be installed and distributed on its own. The firmware-build tools become an optional capability that lights up only when a firmware checkout is present.
Quick start (60 seconds)
Plug in a Meshtastic device, then:
uvx meshtastic-mcp doctor # check what's available
Inside Claude Code (or any MCP client registered with meshtastic):
list_devices() → find your device port
device_info(port="/dev/cu.usbmodem101") → firmware, region, node count
list_nodes(port="/dev/cu.usbmodem101") → mesh peers
send_text(port="/dev/cu.usbmodem101", text="hello mesh")
packets_window(port="/dev/cu.usbmodem101", start="-30s") → confirm TX packet
No firmware checkout required. Core tools work against any serial or TCP device.
Install
# Install the CLI + MCP server (uv recommended; also works with pipx)
uv tool install 'meshtastic-mcp[ui]' # includes camera/OCR support
# or without UI extras:
uv tool install meshtastic-mcp
# other extras: [web] FleetSuite bench UI · [sdr] RF-compliance oracle · [test] pytest harness
# Unreleased master, straight from git (no build step):
uv tool install 'meshtastic-mcp[ui] @ git+https://github.com/meshtastic/meshtastic-mcp'
# Install from a local checkout (dev):
uv tool install --editable '/path/to/meshtastic-mcp[ui]'
# One step: register the server in your MCP client + install the bundled skills
meshtastic-mcp install # claude-code user scope; --client cursor|windsurf|claude-desktop
meshtastic-mcp install --local # register the current interpreter (editable/dev install)
meshtastic-mcp install --print # just emit the JSON snippet (edit nothing)
meshtastic-mcp uninstall # remove the registration (--purge-skills to drop skills too)
# Or do the pieces manually:
claude mcp add meshtastic -s user -- meshtastic-mcp # register with Claude Code설치
uvx meshtastic-mcp doctor # check what's available