zigbee2mqtt-mcp — MCP-сервер для Claude Code: обзор и запуск
Подключает ассистента к брокеру Zigbee2MQTT для проверки сети, связывания устройств, мониторинга батарей и обновления прошивок через протокол stdio.
claude mcp add --env Z2M_MQTT_URL=<Z2M_MQTT_URL> --env Z2M_MQTT_USERNAME=<Z2M_MQTT_USERNAME> --env Z2M_MQTT_PASSWORD=<Z2M_MQTT_PASSWORD> --env Z2M_BASE_TOPIC=<Z2M_BASE_TOPIC> --env Z2M_WRITE_MODE=<Z2M_WRITE_MODE> --transport stdio zigbee2mqtt-mcp -- npx -y zigbee2mqtt-mcpЧто делает zigbee2mqtt-mcp
Сервер подключается к брокеру MQTT напрямую через stdio, минуя веб-интерфейс Zigbee2MQTT. База данных не требуется. Актуальное состояние сети кэшируется в оперативной памяти из retained-сообщений брокера. Каждому запросу сопоставляется идентификатор транзакции, поэтому параллельные вызовы не конфликтуют.
Управление разделено на три уровня доступа: off, safe и full. По умолчанию включён безопасный режим safe. Он позволяет настраивать привязки, опрашивать датчики и управлять группами. Опасные операции вроде удаления узлов или перепрошивки заблокированы до перехода в режим full и требуют подтверждения параметром confirm: true.
Без Node.js 22 и прямого сетевого доступа к брокеру MQTT сервер не запустится. Для части диагностических эндпоинтов моста обязателен Zigbee2MQTT 2.x.
Какие задачи решает
- проверить качество связи и топологию сети Zigbee
- найти устройства с низким зарядом батареи или долгим отсутствием связи
- настроить группы и прямое связывание устройств без веб-интерфейса
- включить сопряжение новых датчиков через команду ассистенту
Примеры запросов агенту
- Найди все устройства Zigbee с уровнем батареи ниже 20% или слабым сигналом
- Включи режим сопряжения permit_join на мосту Zigbee2MQTT
- Проверь статус подключения к брокеру через z2m_connection_status
Как установить zigbee2mqtt-mcp
Командой платформы
claude mcp add --env Z2M_MQTT_URL=<Z2M_MQTT_URL> --env Z2M_MQTT_USERNAME=<Z2M_MQTT_USERNAME> --env Z2M_MQTT_PASSWORD=<Z2M_MQTT_PASSWORD> --env Z2M_BASE_TOPIC=<Z2M_BASE_TOPIC> --env Z2M_WRITE_MODE=<Z2M_WRITE_MODE> --transport stdio zigbee2mqtt-mcp -- npx -y zigbee2mqtt-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add zigbee2mqtt-mcp --env Z2M_MQTT_URL=<Z2M_MQTT_URL> --env Z2M_MQTT_USERNAME=<Z2M_MQTT_USERNAME> --env Z2M_MQTT_PASSWORD=<Z2M_MQTT_PASSWORD> --env Z2M_BASE_TOPIC=<Z2M_BASE_TOPIC> --env Z2M_WRITE_MODE=<Z2M_WRITE_MODE> -- npx -y zigbee2mqtt-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"zigbee2mqtt-mcp": {
"command": "npx",
"args": [
"-y",
"zigbee2mqtt-mcp"
],
"env": {
"Z2M_MQTT_URL": "<Z2M_MQTT_URL>",
"Z2M_MQTT_USERNAME": "<Z2M_MQTT_USERNAME>",
"Z2M_MQTT_PASSWORD": "<Z2M_MQTT_PASSWORD>",
"Z2M_BASE_TOPIC": "<Z2M_BASE_TOPIC>",
"Z2M_WRITE_MODE": "<Z2M_WRITE_MODE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"zigbee2mqtt-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zigbee2mqtt-mcp"
],
"env": {
"Z2M_MQTT_URL": "<Z2M_MQTT_URL>",
"Z2M_MQTT_USERNAME": "<Z2M_MQTT_USERNAME>",
"Z2M_MQTT_PASSWORD": "<Z2M_MQTT_PASSWORD>",
"Z2M_BASE_TOPIC": "<Z2M_BASE_TOPIC>",
"Z2M_WRITE_MODE": "<Z2M_WRITE_MODE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e Z2M_MQTT_URL=<Z2M_MQTT_URL> -e Z2M_MQTT_USERNAME=<Z2M_MQTT_USERNAME> -e Z2M_MQTT_PASSWORD=<Z2M_MQTT_PASSWORD> -e Z2M_BASE_TOPIC=<Z2M_BASE_TOPIC> -e Z2M_WRITE_MODE=<Z2M_WRITE_MODE> zigbee2mqtt-mcp npx -y zigbee2mqtt-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о zigbee2mqtt-mcp
Как установить zigbee2mqtt-mcp в Claude Code?
Выполните команду claude mcp add zigbee2mqtt-mcp -e Z2M_MQTT_URL=<Z2M_MQTT_URL> -e Z2M_MQTT_PASSWORD=<Z2M_MQTT_PASSWORD> -- npx -y zigbee2mqtt-mcp, указав адрес своего брокера MQTT и пароль к нему.
Зачем нужен zigbee2mqtt-mcp, если есть интеграция с Home Assistant?
Home Assistant управляет конечными выключателями и датчиками, но скрывает диагностику самого моста. Сервер даёт прямой доступ к топологии сети, уровням LQI, интервалам отчётов и параметрам привязки.
Что требуется для работы сервера?
Необходимы Node.js 22 или новее, сетевой доступ к порту брокера MQTT и Zigbee2MQTT версии 2.x для поддержки всех диагностических эндпоинтов.
