ZigBee2MQTT用のモデルコンテキストプロトコル(MCP)サーバーで、AIアシスタントのインテリジェントなデバイス検出と制御を実現します。

バックアップ リモート対応! このMCPサーバーは、リモートサーバー(MQTTブローカーが実行するなど)で実行できます。また、MacからHTTP経由でアクセスすることができます。 詳細については、REMOTE-SETUP.mdを参照してください。

展開オプション

• ローカル(stdio): コンテナは、あなたのMac上で実行され、stdioを介してアクセス
• リモート(HTTP/SSE): コンテナはサーバ上で実行し、HTTP → REMOTE-SETUP.md 経由でアクセス

概要

このMCPサーバーはMQTTブローカーに接続し、ZigBee2MQTT経由で接続されたすべてのZigBeeデバイスを自動的に分析します。 各デバイスの構造と機能を学び、MCPツールを通じてAIアシスタントにこの情報を提供できます。

コア機能

-** インテリジェントスキーマディスカバリー**:デバイスの構造と機能を自動的に学習

• ** ** コンパクトデータストレージ**: メタデータとスキーマのみを保存し、メッセージ履歴を完了しない -Zigbee2MQTTドキュメント: 公式デバイスドキュメントへの直接アクセス
• ** インストーラー-Ready**: Docker Compose で簡単に展開

ZigBee2MQTT MCP Server

A Model Context Protocol (MCP) server for ZigBee2MQTT that provides intelligent device discovery and control for AI assistants.

🌐 Remote-Capable! This MCP server can run on a remote server (e.g., where your MQTT broker runs) and you can access it from your Mac via HTTP. See REMOTE-SETUP.md for details!

Deployment Options

• Local (stdio): Container runs on your Mac, accessed via stdio
• Remote (HTTP/SSE): Container runs on server, accessed via HTTP → REMOTE-SETUP.md

Overview

This MCP server connects to your MQTT broker and automatically analyzes all ZigBee devices connected via ZigBee2MQTT. It learns the structure and capabilities of each device and makes this information available to AI assistants through MCP tools.

Core Features

• 🔍 Intelligent Schema Discovery: Automatically learns the structure and capabilities of your devices
• 💾 Compact Data Storage: Stores only metadata and schemas, not complete message history
• 📚 Zigbee2MQTT Documentation: Direct access to official device documentation
• 🐳 Docker-Ready: Easy deployment with Docker Compose
• 🌐 Remote-Capable: Runs on server, access via HTTP/SSE from anywhere
• 🔒 Security: Optional API key authentication
• 🔌 Retained Messages: Uses MQTT retained messages for instant access to device information
• 🏠 Home Automation: Perfect for n8n, Home Assistant and other automation tools

What is Stored?

✅ Device Metadata (Name, model, manufacturer) ✅ Field Schemas (Which fields does a device have? What data types?) ✅ Capabilities (Can dim, change color, measure temperature, etc.) ✅ Current State (Only last value, no history)

❌ Not Stored: Complete message history, time-based sensor data

Estimated Database Size: ~1-2 MB for 100 devices (instead of GB with full history!)

Prerequisites

• Node.js 20+ or Docker
• Running ZigBee2MQTT installation
• MQTT Broker (e.g., Mosquitto)

Installation

Option 1: Docker (Recommended)

1. Clone repository

   git clone 
   cd zigbeeMCP
   

2. Create environment file

   cp .env.example .env
   

3. Configure .env

   MQTT_BROKER_URL=mqtt://192.168.1.100:1883
   MQTT_USERNAME=your_user
   MQTT_PASSWORD=your_password
   MQTT_BASE_TOPIC=zigbee2mqtt
   DB_PATH=/data/zigbee2mqtt.db
   
   # Log Level: debug, info, warn, error, silent
   # Recommended: error (minimal output)
   LOG_LEVEL=error
   

4. Start container

   docker compose up -d
   

5. View logs

   docker compose logs -f
   

Option 2: Local Installation

1. Install dependencies

   npm install
   

2. Compile TypeScript

   npm run build
   

3. Start

   npm start
   

MCP Configuration

Claude Desktop