zigbee2mqtt-mcp：让智能体体检和维护你的 Zigbee 网络

智能家居里的 Zigbee 设备一多，开关灯早就不成问题，真正费神的是哪个传感器信号弱、哪几个电池快没电、哪台设备总在重新入网。Home Assistant 能让智能体控制设备，却不开放 Zigbee2MQTT 网桥这一层。zigbee2mqtt-mcp 专管这一层：它直接走 Zigbee2MQTT 的 MQTT 网桥 API，所以不管你用 Home Assistant、Node-RED、openHAB 还是什么都不用，都能接。

能做什么

• 整网体检：z2m_health_report 一次给出全网审计，z2m_list_devices 可按信号质量、电量、是否有待更新排序筛选。
• 拓扑诊断：z2m_network_map 画出 Mesh 拓扑，标出父节点、深度、链路质量和孤立设备。
• 设备维护：查设备详情和绑定关系，重新 interview、配置上报间隔、改选项、重命名、管理分组。
• 配对和绑定：z2m_permit_join 打开配网窗口，z2m_bind 把遥控器直接绑到灯上，网桥挂了也能用。
• 固件和重启：z2m_check_updates 查 OTA，full 模式下才开放刷固件、删设备、重启网桥。

适合谁

• 家里有几十个 Zigbee 设备、想定期让智能体出一份“哪些要换电池、哪些信号差”报告的人。
• 帮别人维护智能家居的集成商，需要快速定位网络问题。

接入方式

需要 Node.js 22 以上，能访问 Zigbee2MQTT 使用的 MQTT broker。Claude Desktop 配置：

{
  "mcpServers": {
    "zigbee2mqtt": {
      "command": "npx",
      "args": ["-y", "zigbee2mqtt-mcp"],
      "env": {
        "Z2M_MQTT_URL": "mqtt://192.168.1.10:1883"
      }
    }
  }
}

Z2M_MQTT_URL 填 broker 地址，不是 Zigbee2MQTT 前端的端口。

编辑点评

这是我们在家居自动化方向找到的最用心的小项目：没有数据库、没有常驻进程，随会话启停；每个请求带事务 ID，并发调用不会串；写操作分 off、safe、full 三档，高于当前档位的工具根本不注册，删除设备、刷固件这类操作每次还要 confirm: true。要注意默认的 safe 档已经能通过 z2m_set_state 控制网内任何设备，包括门锁、阀门和警报器，担心的话设成 off；打开配网窗口期间附近任何 Zigbee 设备都能加入。许可证为 MIT。