Debmatic MCP Server

@claymore666

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

claymore666

提交者

Chris

关于 Debmatic MCP Server

# debmatic-mcp

#mcp#homematic#debmatic#ccu#smart-home #home-automation #iot#raspberrymatic#homematic-ip#eq3

Debmatic MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "debmatic": {
      "command": "npx",
      "args": [
        "debmatic-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "your-ccu-hostname-or-ip",
        "CCU_PASSWORD": "your-ccu-admin-password"
      }
    }
  }
}

Debmatic MCP Server 工具

List all devices with their channels, types, and addresses. Optional filters: room, function, type, name. Use this first to discover device addresses for get_value/set_value.

List available communication interfaces (BidCos-RF, HmIP-RF, VirtualDevices, etc.).

List all rooms with their assigned channel IDs. Use with list_devices to find devices by room.

List all function groups (Heating, Lighting, etc.) with their assigned channel IDs.

List all automation programs. Use execute_program to trigger them.

List all system variables with current values and metadata. Use set_system_variable to modify them.

Get the full channel/datapoint schema for a device type (e.g. 'HmIP-eTRV-2'). Shows all channels, paramsets, datapoint names, types, ranges, and operations. Served from cache (instant). Use list_devices first to find device types.

Read a single datapoint value from a device channel. Only address and valueKey are required — interface is auto-resolved. Use list_devices to find addresses, describe_device_type to find valid valueKeys.

Read datapoint values for multiple channels at once via HM Script. Provide either a list of channel addresses, or filter by room or function name.

Read all parameters for a channel (VALUES, MASTER, or LINK). Interface is auto-resolved from the address.

Set a single datapoint value on a device channel. Only address, valueKey, and value are required — interface and type are auto-resolved. Returns the previous value for undo. Use describe_device_type to find valid valueKeys and ranges.

Write multiple parameters at once (e.g. thermostat weekly profile). Interface is auto-resolved from address.

Set a system variable value. Type is auto-detected — use list_system_variables to see available variables.

Trigger an automation program on the CCU. NOT idempotent — will not be auto-retried. Use list_programs to find program IDs.

Get all active service messages (low battery, unreachable, etc.) with device details and timestamps.

Get CCU system information: firmware version, serial number, addresses.

Context-aware help. No args: conceptual guide. Tool name (e.g. 'set_value'): tool usage. Device type (e.g. 'HmIP-eTRV-2'): capabilities from cache.

Execute arbitrary HomeMatic Script on the CCU. NOT idempotent — will not be auto-retried. Use for anything the other tools don't cover.

概览

What is Debmatic Mcp?

Debmatic Mcp connects to any HomeMatic CCU (debmatic, CCU3, or OpenCCU) via its built-in JSON-RPC API and exposes devices, rooms, programs, and system variables as MCP tools. It works directly on your local network — no addons, no XML-API, no cloud required.

How to use Debmatic Mcp?

Install via npx ccu-mcp --stdio or run a Docker container with environment variables CCU_HOST and CCU_PASSWORD. Configure your MCP client (e.g., Claude Code) by adding a debmatic server entry in .mcp.json — either as a stdio subprocess or an HTTP server. The HTTP mode uses a bearer token generated on first startup.

Key features of Debmatic Mcp

Connects directly to any HomeMatic CCU via its JSON-RPC API
Exposes devices, rooms, programs, and system variables as MCP tools
Supports stdio (subprocess) and HTTP (standalone) transports
Bearer token authentication with rotation, TTL, and grace period
TLS support with cert pinning, CA trust, or system verification
CORS and DNS-rebinding protection for secure HTTP access

Use cases of Debmatic Mcp

Ask an AI assistant for room temperatures, open windows, or low‑battery devices
Set heating to a specific temperature or rename devices with consistent naming
Find which room a window sensor belongs to or list devices with stale data
Read gas meter readings or detect naming inconsistencies across channels

常见问题

What are the prerequisites?

A running HomeMatic CCU (debmatic, CCU3, or OpenCCU) reachable on your network, the CCU’s admin username and password, and Node.js 22+ (for stdio mode) or Docker.

How do I get the auth token for HTTP mode?

Run `docker exec ccu-mcp grep MCP_AUTH_TOKEN /data/.env` — the token is the part after `=`. The server generates it on first startup and saves it to the container’s data volume.

Does it work with HTTPS? How do I handle self‑signed certificates?

Yes. Set `CCU_HTTPS=true` and optionally `CCU_PORT=443`. The server accepts self‑signed certificates by default — you can pin the certificate fingerprint via `CCU_TLS_FINGERPRINT`, trust a CA file via `CCU_CA_CERT`, or enable system trust with `CCU_TLS_VERIFY=true`.

How can I protect against brute‑force attacks?

Use fail2ban. The server logs every rejected request as a structured JSON line to stderr, making it easy to parse. Ready‑to‑use fail2ban filter and jail configuration are provided in the `fail2ban/` directory.

What transport options are available?

Stdio (the server runs as a subprocess of the MCP client) and HTTP (a standalone Docker container that clients connect to over the network). Both are fully supported.

其他分类下的更多 MCP 服务器

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one