{"name":"Meshtastic-MCP: AI Tooling for Meshtastic Device Control and Testing","description":"Meshtastic-MCP provides an MCP server and agent skills designed for AI tooling to discover, drive, observe, and test Meshtastic devices and applications. It offers a comprehensive suite of capabilities, from portable device control to advanced hardware-free end-to-end testing and replay functionalities. This project aims to streamline the development and testing of Meshtastic ecosystems.","github":"https://github.com/meshtastic/meshtastic-mcp","url":"https://osrepos.com/repo/meshtastic-meshtastic-mcp","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/meshtastic-meshtastic-mcp","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/meshtastic-meshtastic-mcp.md","json":"https://osrepos.com/repo/meshtastic-meshtastic-mcp.json","topics":["Python","Meshtastic","AI","IoT","Testing","Automation","MCP"],"keywords":["Python","Meshtastic","AI","IoT","Testing","Automation","MCP"],"stars":null,"summary":"Meshtastic-MCP provides an MCP server and agent skills designed for AI tooling to discover, drive, observe, and test Meshtastic devices and applications. It offers a comprehensive suite of capabilities, from portable device control to advanced hardware-free end-to-end testing and replay functionalities. This project aims to streamline the development and testing of Meshtastic ecosystems.","content":"## Introduction\n\nMeshtastic-MCP is a powerful Python project designed to provide an MCP (Model Context Protocol) server and a suite of agent skills for interacting with Meshtastic devices and applications. It enables AI tooling to seamlessly discover, drive, observe, and test Meshtastic ecosystems, offering a robust framework for automation and development.\n\n## Why Use It and Key Features\n\nThis repository is crucial for anyone looking to automate or deeply test Meshtastic setups, especially with AI integration. It offers a comprehensive set of capabilities:\n\n*   **AI-Driven Device Control and Testing**: Meshtastic-MCP allows AI agents to perform closed-loop device and app end-to-end testing, streamlining development workflows.\n*   **Portable Core**: Works with any connected Meshtastic device, supporting serial and TCP connections for basic operations like discovery, device information, sending messages, and recording data, without requiring firmware checkouts.\n*   **Firmware Management**: Integrates with PlatformIO to build, clean, flash, and perform OTA updates for Meshtastic firmware.\n*   **Hardware-Free End-to-End Testing**: Orchestrates Android emulators and iOS simulators for comprehensive testing of Meshtastic apps without physical hardware.\n*   **RF Compliance with SDR**: Utilizes SDR dongles for RF compliance checks, including occupancy scans and on-air TX verification.\n*   **Local Model Integration**: Offloads token-heavy tasks like summarizing recorder windows or triaging e2e failures to local GPUs via Ollama or OpenAI-compatible servers.\n*   **Replay Functionality**: Simulates Meshtastic devices by serving captured mesh data over TCP, allowing for reproducible app/UI development and testing with fully controllable, synthetic meshes.\n*   **FleetSuite Web Control Plane**: Provides a local web UI for managing a multi-board hardware bench, offering live device registry, build queues, flashing, recovery, and camera streams for screen assertions.\n*   **Hardware Test Suite**: Includes a tiered pytest suite for unit, mesh, telemetry, and recovery tests, supporting various Meshtastic boards on a USB-hub bench.\n*   **Decoupled Design**: Extracted from the main Meshtastic firmware repository, it can be installed and distributed independently, with firmware-build tools activating only when a firmware checkout is present.\n\n## Installation\n\nTo get started with Meshtastic-MCP, you can install it using `uv` (recommended) or `pipx`.\n\nFirst, install the CLI and MCP server:\n\nbash\n# Install the CLI + MCP server (uv recommended; also works with pipx)\nuv tool install 'meshtastic-mcp[ui]'       # includes camera/OCR support\n# or without UI extras:\nuv tool install meshtastic-mcp\n\n\nThen, register the server with your MCP client and install the bundled skills:\n\nbash\nmeshtastic-mcp install                 # claude-code user scope; --client cursor|windsurf|claude-desktop\n\n\n## Examples\n\nHere are some quick examples to demonstrate how to use Meshtastic-MCP:\n\nCheck available components and dependencies:\n\nbash\nuvx meshtastic-mcp doctor          # check what's available\n\n\nInside an MCP client like Claude Code, you can interact with your Meshtastic devices:\n\npython\nlist_devices()                          # find your device port\ndevice_info(port=\"/dev/cu.usbmodem101\") # firmware, region, node count\nlist_nodes(port=\"/dev/cu.usbmodem101\")  # mesh peers\nsend_text(port=\"/dev/cu.usbmodem101\", text=\"hello mesh\")\npackets_window(port=\"/dev/cu.usbmodem101\", start=\"-30s\")  # confirm TX packet\n\n\n## Links\n\n*   **GitHub Repository**: <a href=\"https://github.com/meshtastic/meshtastic-mcp\" target=\"_blank\">meshtastic/meshtastic-mcp</a>","metrics":{"detailViews":2,"githubClicks":2},"dates":{"published":null,"modified":"2026-09-27T07:14:23.000Z"}}