MM

meshtastic/meshtastic-mcp

开发工具官方

本页由 AI 翻译,技术细节请以原文为准。 查看原文

19 stars 8 forks 质量 78 趋势 42GPL-3.0

MCP 服务器+ AI 工具的代理技能,用于发现、驱动、观察和测试 Meshtastic 设备及应用软件

概览

一个用于AI工具的Meshtastic设备以及与之交谈的应用程序的家. MCP服务器外加捆绑的代理技能集,用于闭路设备QQ App端到端测试. 从Meshtastic固件Repo的mcp-server/中被取出并解相,因此可以自行安装并发售. 固件建设工具成为一种可选能力,只有在固件检出时才能点出. Claude Code内部(或任何用 meshtastic 注册的 MCP 客户端): 不需要固件检出 。 核心工具可以对抗任何串行或TCP设备. 安装客户端的 mcpServers JSON 就位(保留其他条目)——它每客户端选择正确的配置路径(claude-code-desktop / s光标/windurf)和 --scope(用户/项目),或通过 -- config PATH. 加入容量为-env nucle=VALUE的 vars 。 重启MCP客户端取取更改. MCP客户端持续运行旧服务器,直到您重新启动它.

概述(AI 翻译)

AI工具的家 发现、驱动、观察和测试** 金属装置和 和他们说话的应用程序。 MCP 服务器加捆绑 闭路设备QQA应用端到端测试的代理技能集.

从Meshtastic固件Repo的mcp-server/中被取出并脱钩,因此可以 自行安装和分发。 固件制造工具成为可选工具 只有在有固件取出时才亮出的能力。

□快起行 (60秒)

插入元件,然后:

Claude代码内部(或用meshtastic注册的任何MCP客户端) :

不需要固件检出 。 核心工具可以对抗任何串行或TCP设备.

□ 安装

install编辑客户端的[T3] JSON已就位(保留其他条目)——它选择 右配置路径每 --client ( Claude-code / claude-desktop / s光标 / windurf 和 --scope) (用户/项目),或通过--config PATH。 以 --env KEY=VALUE 添加容量 vars。 重启MCP客户端取取更改.

  • 更新

MCP客户端持续运行旧服务器,直到您重新启动它.

QQ 源重置( 可选能力)

本页由 AI 翻译,技术细节请以原文为准。

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
在 GitHub 查看完整 README

安装

uvx meshtastic-mcp doctor # check what's available
新手?先看 mcpskill.org 教程 →