Zigbee2MQTTのプロパティでadministering用のモデルコンテキストプロトコルサーバー。

ほとんどのZigbeeインテグレーションは、すでにアシスタントがライトオンにします。 これは、下層のためです: メッシュ健康, 弱いリンク, 再結合し続けるデバイス, 予備バッテリー, ファームウェアのアップデート, ペアリング, 結合, 間隔とデバイスオプションを報告 — あなたが通常Zigbee2MQTTのフロントエンドを開くもの.

Zigbee2MQTT MQTTブリッジAPIに直接話しているので、ホームアシスタント、Node-RED、openHAB、またはまったく使用していないかに関係なく動作します。 Zigbee2MQTT 2.x に対してテスト済み。 bridge/health] や device/binds/clear 、 OTA のスケジューリングトピックを含む、そこに存在するブリッジエンドポイントに依存するツールがいくつかあります。

なぜこれが存在しているのか

既にホームアシスタントを実行すると、Zigbeeデバイスが露出し、アシスタントが制御できます。 Home Assistantがnot exposeがブリッジそのものである:リンク品質、メッシュトポロジー、インタビュー状態、OTAの可用性、[permit_join]]、デバイスオプション、バインディング、レポート構成。 このサーバーは、そのギャップを正確に埋めます。

デザイン

• **データベースはありません.

zigbee2mqtt-mcp

A Model Context Protocol server for administering a Zigbee2MQTT estate.

Most Zigbee integrations already let an assistant turn a light on. This one is for the layer underneath: mesh health, weak links, devices that keep rejoining, stale batteries, firmware updates, pairing, binding, reporting intervals and device options — the things you normally open the Zigbee2MQTT frontend for.

It talks directly to the Zigbee2MQTT MQTT bridge API, so it works regardless of whether you use Home Assistant, Node-RED, openHAB or nothing at all. Tested against Zigbee2MQTT 2.x; several tools depend on bridge endpoints that only exist there, including bridge/health, device/binds/clear and the OTA scheduling topics.

Why this exists

If you already run Home Assistant, your Zigbee devices are exposed there and an assistant can control them. What Home Assistant does not expose is the bridge itself: link quality, mesh topology, interview state, OTA availability, permit_join, device options, bindings and reporting configuration. This server fills exactly that gap.

Design

• No database. Zigbee2MQTT publishes its bridge topics as retained messages, so a fresh subscription yields a complete picture in a few hundred milliseconds. The server keeps only the latest payload per topic in memory.
• No daemon. Pure stdio. It starts and dies with the MCP session.
• Correlated requests. Every bridge/request/* carries a transaction id and is matched to its bridge/response/*, so concurrent calls cannot cross wires.
• Tiered writes. Destructive operations are gated behind a write mode and an explicit confirm argument.

Install

Requires Node.js 22 or newer and network access to the MQTT broker that Zigbee2MQTT uses.

npx zigbee2mqtt-mcp

VS Code / GitHub Copilot

Add to your MCP configuration:

{
  "servers": {
    "zigbee2mqtt": {
      "command": "npx",
      "args": ["-y", "zigbee2mqtt-mcp"],
      "env": {
        "Z2M_MQTT_URL": "mqtt://192.168.1.10:1883",
        "Z2M_MQTT_USERNAME": "mqtt",
        "Z2M_MQTT_PASSWORD": "${input:z2mPassword}"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "zigbee2mqtt": {