MESH-API MCP
Мост между LoRa-сетями Meshtastic и MeshCore и ИИ: MCP-сервер дает агенту слать сообщения, читать узлы и вызывать расширения
- 185 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Агент может писать в радиоэфир от имени узла и запускать любые слэш-команды, в том числе расширения с отправкой в Discord и SMS.
- Экстренная рассылка идет через Twilio, почту и Discord с координатами GPS; она закрыта флагом, но при его включении уходит реальным людям.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mesh-apiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может писать в радиоэфир от имени узла и запускать любые слэш-команды, в том числе расширения с отправкой в Discord и SMS.
- Экстренная рассылка идет через Twilio, почту и Discord с координатами GPS; она закрыта флагом, но при его включении уходит реальным людям.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MESH-API — программа на Python, которая соединяет радиосети Meshtastic и MeshCore (LoRa) с чат-ботами и внешними API. Она отвечает на сообщения узлов через LM Studio, Ollama, OpenAI, Claude, Gemini и другие модели, пересылает сообщения между сетями, Discord, MQTT и Home Assistant и рассылает экстренные оповещения по SMS через Twilio, почте и в Discord. Работают 30 встроенных расширений и веб-панель на порту 5000. Встроенный MCP-сервер по адресу `POST /mcp` превращает MESH-API в рабочий бэкенд для ИИ-агентов. Инструменты ядра: `mesh_send_message`, `mesh_list_nodes`, `mesh_get_messages`, `mesh_network_status`, `mesh_list_channels`, `mesh_ai_query`, `mesh_list_commands`, `mesh_run_command`, `meshcore_list_contacts` и `mesh_send_emergency`, закрытый флагом. Каждая слэш-команда расширения автоматически становится инструментом `ext_cmd_<команда>`. Сервер выключен по умолчанию и защищен Bearer-токеном.
Для кого. Радиолюбителям и операторам автономных сетей Meshtastic и MeshCore, которые хотят дать ИИ-агенту доступ к сети и связать ее с домашней автоматикой.
Подходит, если
- Агент по запросу читает последние сообщения сети и список узлов с расстоянием и временем последнего приема.
- На сообщение из LoRa-сети отвечает локальная модель через Ollama или LM Studio, интернет для этого не нужен.
- Сообщения между Meshtastic, MeshCore и Discord пересылают с одного узла-моста.
- Команду расширения вызывают из агента как инструмент `ext_cmd_<команда>`, не заходя в веб-панель.
- Дом на Home Assistant отвечает на сообщения из сети, а доступ к нему закрыт пином.
Не подходит, если
- Связь критична или нужна для экстренных случаев: автор советует не полагаться на проект и держать запасные каналы.
- Сеть публичная, например канал LongFast: ИИ-боты там нежелательны, поэтому ответы на нем по умолчанию выключены.
- Агенту нельзя дать возможность писать в эфир: инструменты отправки и запуска команд меняют то, что слышат другие узлы.
- У вас нет ни радиоузла Meshtastic, ни MeshCore: без радио серверу нечего связывать.
Пример запроса к агенту
Через MESH-API покажи, какие узлы были слышны за последний час, и прочитай последние 20 сообщений канала. В эфир ничего не отправляй.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
Проект экспериментальный и в стадии беты: поддержка MeshCore и MCP еще мало проверена в реальных сетях, автор просит сообщать об ошибках. Нужен Python 3.11 или новее либо образ Docker для linux/amd64 и linux/arm64. MCP по умолчанию выключен: его включают в блоке `mcp` файла `config.json`, там же задают токен, список разрешенных источников и лимит запросов в минуту. Экстренный инструмент открывается отдельным флагом `allow_emergency`. Прошивку устройств из панели обновлять можно только после включения `firmware.allow_flashing`, по умолчанию она выключена.
Как отключить. Поставьте `"enabled": false` в блоке `mcp` файла `config.json` и перезапустите сервер, затем удалите запись из конфигурации агента. Токен можно сменить, очистив поле `auth_token`.
Частые вопросы
Как включить MCP-сервер в MESH-API?
В `config.json` поставьте `"enabled": true` в блоке `mcp`. Остальные поля: `require_auth`, `auth_token`, `allowed_origins`, `allow_emergency` и `rate_limit_per_min`. При первом запуске с включенной авторизацией токен вида `mesh-mcp-XXXX` создается и печатается в лог.
Как подключить Claude Desktop?
Транспорт сервера — Streamable HTTP, поэтому для Claude Desktop нужен мост `mcp-remote`: команда `npx -y mcp-remote http://<хост>:5000/mcp --header "Authorization: Bearer mesh-mcp-ВАШ_ТОКЕН"`. Клиенты с поддержкой HTTP подключаются к адресу напрямую.
Какие инструменты есть у агента?
Отправка сообщения в одну сеть, обе или автоматически, список узлов, чтение журнала сообщений, состояние обеих радиосетей, список каналов, запрос к ИИ, запуск слэш-команд, контакты MeshCore и экстренная рассылка. Команды расширений добавляются как `ext_cmd_<команда>`.
Можно ли запустить в Docker?
Да, есть образы для linux/amd64 и linux/arm64. Склонируйте репозиторий, скопируйте папку `docker-required-volumes/mesh-api` в рабочий каталог и отредактируйте файлы в `mesh-api/config/` перед запуском. Для Raspberry Pi 4 и 5 подходит arm64.
Отвечает ли бот на публичном канале LongFast?
Нет, по умолчанию бот молчит на LongFast, чтобы не создавать нагрузку на эфир. Ответы включает флаг `ai_respond_on_longfast`, но автор советует это делать только в изолированной сети с согласия сообщества.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации
Open Agent Email — свой почтовый сервер для ИИ-агентов: ящики, ответы в ветке письма, одобрение человеком, вебхуки и MCP на 96 инструментов
MCP-сервер для мессенджера MAX
mcp-max-messenger
MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента
Discord MCP от cappyeo — более 200 инструментов
Discord MCP (cappyeo)
Discord MCP с более чем 200 инструментами: агент ведет сообщения, роли и модерацию, собирает сервер по плану, а запись по умолчанию в режиме предпросмотра
MCP сервер для Home Assistant: агент читает состояние устройств, управляет ими и правит дашборды умного дома
Интеграция Home Assistant, которая ставит GigaChat, YandexGPT или другую LLM за голосового ассистента умного дома
Коротко о README
Страница проекта открывается призывом о поддержке и журналом изменений линейки 0.7. Затем идут описание возможностей, инструкции по запуску для Windows, Linux и Docker, справочник расширений и раздел про MCP.