Mcp Server For Deconz Server

What is Mcp Server For Deconz Server?

An MCP server that exposes the deCONZ REST API to AI assistants, enabling natural‑language control of Zigbee lights, sensors, groups, scenes, rules, and schedules. It supports stdio, SSE, and Streamable HTTP transports with optional bearer token authentication.

How to use Mcp Server For Deconz Server?

Install via git clone and uv sync (or pip install -e .). Set environment variables DECONZ_HOST and DECONZ_API_KEY, then run deconz-mcp with the desired transport (--transport stdio, --transport streamable-http, etc.). For Claude Desktop, add the server to claude_desktop_config.json with the appropriate command and environment variables.

Key features of Mcp Server For Deconz Server

• Exposes lights, sensors, groups, scenes, rules, schedules, and Touchlink tools
• Read‑only resources: deconz://lights, deconz://config, deconz://state, and more
• Pre‑built prompts for home overview, control lights, manage scenes, add device, setup automation, diagnose device, evening routine
• Supports stdio, SSE, Streamable HTTP, and combined server transports
• Bearer token authentication with constant‑time comparison for HTTP transports
• Docker image (multi‑platform) and Docker Compose / Kubernetes deployment manifests

Use cases of Mcp Server For Deconz Server

• Ask an AI assistant to turn lights on/off, dim, or change colour in a specific room
• Automate routines based on sensor triggers (motion, temperature) via rule creation
• Create, recall, or update scenes and schedules for time‑based lighting control
• Diagnose unreachable devices or view full gateway state through prompts and resources
• Pair new Zigbee devices using touchlink_scan and touchlink_identify tools

FAQ from Mcp Server For Deconz Server

What are the requirements for Mcp Server For Deconz Server?

Python 3.10 or later, uv (recommended) or pip, a running deCONZ / Phoscon gateway with a ConBee or RaspBee adapter, and a valid deCONZ REST API key.

How do I obtain a deCONZ REST API key?

Open the Phoscon app, go to Menu → Settings → Gateway → Advanced, click Authenticate app, then within 60 seconds run curl -X POST http://<gateway-ip>/api with the appropriate JSON body. The response contains your API key.

Can I configure the gateway at runtime instead of using environment variables?

Yes, the configure_deconz tool lets you point the server at a deCONZ gateway at runtime (specifying host, port, and API key), so environment variables are not strictly required when using stdio.

What transport modes does Mcp Server For Deconz Server support?

Four transport modes: stdio (stdin/stdout, for Claude Desktop), sse (legacy SSE), streamable-http (modern MCP Streamable HTTP on /mcp), and server (combined SSE + Streamable HTTP on one port).

How do I secure the HTTP transports?

Set the MCP_AUTH_TOKEN environment variable (or --auth-token CLI flag). Every HTTP request must then include Authorization: Bearer <token>; the token is verified with a constant‑time comparison. Bearer auth is strongly recommended for transports exposed beyond localhost.