# meshtastic-mcp

MCP-сервер meshtastic-mcp для Claude Code обнаруживает, настраивает и тестирует устройства Meshtastic через Serial и TCP.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23 у репозитория
- Автор: meshtastic
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/meshtastic/meshtastic-mcp
- Обновлён: 2026-11-17
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/meshtastic-mcp

## Что делает

Инструмент подключает ИИ-агентов к радиоустройствам Meshtastic для сквозного тестирования и управления железом. Портативное ядро работает с любым подключенным через порт или сеть узлом без предварительной сборки прошивки.

Пакет запускается через `uvx` и регистрируется в клиентах одной командой. Для сборки прошивок или эмуляции Android требуются локальные репозитории и переменные окружения вроде `MESHTASTIC_FIRMWARE_ROOT`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `MESHTASTIC_FIRMWARE_ROOT`, `MESHTASTIC_MCP_TCP_HOST`, `MESHTASTIC_MCP_TOOLSETS`, `MESHTASTIC_MCP_READ_ONLY`, `MESHTASTIC_MCP_CONFIRM`, `MESHTASTIC_MCP_DATA_DIR`, `MESHTASTIC_UI_CAMERA_DEVICE`, `MESHTASTIC_UHUBCTL_LOCATION_TESTER`, `MESHTASTIC_PIO_BIN`, `MESHTASTIC_ANDROID_ROOT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MESHTASTIC_FIRMWARE_ROOT=<MESHTASTIC_FIRMWARE_ROOT> --env MESHTASTIC_MCP_TCP_HOST=<MESHTASTIC_MCP_TCP_HOST> --env MESHTASTIC_MCP_TOOLSETS=<MESHTASTIC_MCP_TOOLSETS> --env MESHTASTIC_MCP_READ_ONLY=<MESHTASTIC_MCP_READ_ONLY> --env MESHTASTIC_MCP_CONFIRM=<MESHTASTIC_MCP_CONFIRM> --transport stdio meshtastic-mcp -- uvx meshtastic-mcp
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from meshtastic-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add meshtastic-mcp --env MESHTASTIC_FIRMWARE_ROOT=<MESHTASTIC_FIRMWARE_ROOT> --env MESHTASTIC_MCP_TCP_HOST=<MESHTASTIC_MCP_TCP_HOST> --env MESHTASTIC_MCP_TOOLSETS=<MESHTASTIC_MCP_TOOLSETS> --env MESHTASTIC_MCP_READ_ONLY=<MESHTASTIC_MCP_READ_ONLY> --env MESHTASTIC_MCP_CONFIRM=<MESHTASTIC_MCP_CONFIRM> -- uvx meshtastic-mcp
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from meshtastic-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "meshtastic-mcp": {
            "command": "uvx",
            "args": [
                "meshtastic-mcp"
            ],
            "env": {
                "MESHTASTIC_FIRMWARE_ROOT": "<MESHTASTIC_FIRMWARE_ROOT>",
                "MESHTASTIC_MCP_TCP_HOST": "<MESHTASTIC_MCP_TCP_HOST>",
                "MESHTASTIC_MCP_TOOLSETS": "<MESHTASTIC_MCP_TOOLSETS>",
                "MESHTASTIC_MCP_READ_ONLY": "<MESHTASTIC_MCP_READ_ONLY>",
                "MESHTASTIC_MCP_CONFIRM": "<MESHTASTIC_MCP_CONFIRM>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from meshtastic-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "meshtastic-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "meshtastic-mcp"
            ],
            "env": {
                "MESHTASTIC_FIRMWARE_ROOT": "<MESHTASTIC_FIRMWARE_ROOT>",
                "MESHTASTIC_MCP_TCP_HOST": "<MESHTASTIC_MCP_TCP_HOST>",
                "MESHTASTIC_MCP_TOOLSETS": "<MESHTASTIC_MCP_TOOLSETS>",
                "MESHTASTIC_MCP_READ_ONLY": "<MESHTASTIC_MCP_READ_ONLY>",
                "MESHTASTIC_MCP_CONFIRM": "<MESHTASTIC_MCP_CONFIRM>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from meshtastic-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MESHTASTIC_FIRMWARE_ROOT=<MESHTASTIC_FIRMWARE_ROOT> -e MESHTASTIC_MCP_TCP_HOST=<MESHTASTIC_MCP_TCP_HOST> -e MESHTASTIC_MCP_TOOLSETS=<MESHTASTIC_MCP_TOOLSETS> -e MESHTASTIC_MCP_READ_ONLY=<MESHTASTIC_MCP_READ_ONLY> -e MESHTASTIC_MCP_CONFIRM=<MESHTASTIC_MCP_CONFIRM> meshtastic-mcp uvx meshtastic-mcp
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from meshtastic-mcp <команда>

## Когда брать
- найти подключенные устройства Meshtastic и узнать их параметры
- отправить тестовое текстовое сообщение в сеть
- собрать и прошить прошивку через PlatformIO
- проверить радиоэфир с помощью SDR-модуля

## Примеры запросов агенту
- Найди доступные устройства через meshtastic-mcp
- Запроси информацию об устройстве на порту /dev/cu.usbmodem101
- Отправь текстовое сообщение на устройство через меш-сеть

## Похожие
- [Serial MCP](https://affpapa.org/nevibecode/mcp/serial-mcp.md) — MCP-сервер · ★ 21 у репозитория
- [pty-mcp](https://affpapa.org/nevibecode/mcp/pty-mcp.md) — MCP-сервер · ★ 20 у репозитория
- [arduino-cli-skill](https://affpapa.org/nevibecode/skills/arduino-cli-skill.md) — скилл · 162 установки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
