Каталог MCP
claymore666/debmatic-mcp

claymore666/debmatic-mcp

Name: claymore666/debmatic-mcp
Availability: InStock
Author: claymore666

ccu-mcp — MCP-сервер для HomeMatic, напрямую подключается к CCU и открывает AI-ассистентам (Claude, Cursor) доступ к устройствам, комнатам и программам. Управляйте отоплением, проверяйте датчики и ...

README

28 инструментов

Версии

Установить сервер

ccu-mcp

Talk to your HomeMatic smart home from Claude, Cursor, or any MCP client.

ccu-mcp connects to the CCU's built-in JSON-RPC API and exposes your devices, rooms, programs, and system variables as MCP tools. No addons, no XML-API, no cloud — just a direct connection to the CCU on your local network.

Works with any HomeMatic CCU: debmatic (HomeMatic on Debian), a CCU3, or OpenCCU (formerly RaspberryMatic) — anything that exposes the standard /api/homematic.cgi endpoint.

What can it do?

Ask your AI assistant things like:

"What's the temperature in the bathroom?"
"Are any windows open?"
"Set the living room heating to 21 degrees"
"Show me all devices with low battery"
"What's the gas meter reading?"
"Which devices have low battery or haven't been seen in a long time?"
"Find all channels whose names don't match their device name"
"Rename all devices to follow a consistent naming convention with floor labels (UG/OG/EG)"
"Which room is the window sensor in?"

Инструменты были проиндексированы: 09.09.2026

acknowledge_service_messagesидемпотентныйвнешний мир

Подтверждает/отклоняет активные сервисные сообщения (например, сбросить предупреждение о низком заряде батареи или недоступности). Укажите alarm id (из get_service_messages), чтобы подтвердить одно сообщение, или адрес канала, чтобы подтвердить все активные сообщения на этом канале. Предупреждение появляется снова, если его условие сохраняется.

Подтверждать служебные сообщения

Параметры

addressstring
Channel address — confirm all active messages on this channel (e.g. '000A1BE9A71F15:0')
confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
idstring
Alarm id from get_service_messages (confirm a single message)

assign_channelидемпотентныйвнешний мир

Назначает канал в комнату и/или функциональную группу. Определяет канал по адресу, а комнату/функцию по имени (используйте list_rooms / list_functions для просмотра имён). Требуется хотя бы одно: комната или функция.

Назначить канал комнате/функции

Параметры

channelstringобязательный
Channel address (e.g. '000A1BE9A71F15:1')
confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
functionstring
Function group name (exact match)
roomstring
Room name (exact match)

create_system_variableвнешний мир

Создаёт новую системную переменную. Типы: 'bool', 'float' (необязательные min/max/unit), 'enum' (требуется список значений), 'string'. Используйте set_system_variable, чтобы затем записать её, list_system_variables, чтобы просмотреть существующие.

Создать системную переменную

Параметры

confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
descriptionstring
Human-readable description shown in the WebUI
maxnumber
Maximum value (float only)
minnumber
Minimum value (float only)
namestringобязательный
New variable name (must not already exist)
typeenumобязательный
Variable type
unitstring
Unit label (float only, e.g. '°C')
valuesstring[]
Enum value labels in order (enum only, e.g. ['off','low','high'])

delete_system_variableидемпотентныйвнешний мир

Удалить системную переменную по имени. Используйте list_system_variables, чтобы увидеть существующие имена. На защищенной цели КАЖДЫЙ вызов требует confirm:true - разблокировка сессии от других инструментов записи не применяется.

Удалить системную переменную

Параметры

confirmboolean
Required true on EVERY call against a protected CCU target (e.g. prod) — deletion never rides on the session unlock.
namestringобязательный
Variable name (exact match)

describe_device_typeтолько чтениевнешний мир

Получает полную схему каналов и точек данных для типа устройства (например, 'HmIP-eTRV-2'). Показывает все каналы, наборы параметров, имена точек данных, типы, диапазоны и операции. Данные из кэша (мгновенно). Сначала используйте list_devices, чтобы найти типы устройств.

Возвращает описание типа устройства.

Параметры

deviceTypestringобязательный
Device type name (e.g. 'HmIP-eTRV-2', 'HmIP-SWDO-I'). Get from list_devices.
targetstring
CCU target to read from (default: active). See list_ccu_targets.

execute_programвнешний мир

Запустить программу автоматизации на CCU. НЕ идемпотентна - не будет автоматически повторена. Используйте list_programs, чтобы найти ID программ.

Выполнить программу

Параметры

confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
idstringобязательный
Program ID. Get from list_programs.

get_connection_infoтолько чтение

Сообщает, какая цель CCU активна в данный момент — хост, пользователь, флаги https, protected/read-only и состояние входа. Используйте это, чтобы подтвердить, ГДЕ будет выполняться команда (особенно перед записью). Без пароля.

Получает информацию о подключении

Параметры

Без параметров.

get_paramsetтолько чтениевнешний мир

Читает все параметры канала: VALUES (состояние во время выполнения), MASTER (конфигурация) или связка параметров — в последнем случае передайте адрес канала LINK PARTNER как paramsetKey (найдите партнёров с помощью list_links). Интерфейс определяется автоматически по адресу.

Get Paramset

Параметры

addressstringобязательный
Channel address (e.g. '000A1BE9A71F15:1')
interfacestring
Interface name override (auto-resolved if omitted)
paramsetKeystringобязательный
'VALUES', 'MASTER', or a link partner's channel address (reads that direct link's parameters)
targetstring
CCU target to read from (default: active). See list_ccu_targets.

get_rssiтолько чтениевнешний мир

Сообщает о качестве радиосвязи (RSSI, в дБм) для каждого устройства с привязкой к именам устройств, а также о состоянии интерфейса BidCos (рабочий цикл, состояние подключения). Охватывает оба транспорта: BidCos-RF через Interface.rssiInfo и HmIP-RF через служебные точки данных RSSI_DEVICE/RSSI_PEER каждого устройства. Используется для ответа на вопрос «почему этот датчик работает нестабильно?». Чем выше (ближе к 0) дБм, тем лучше; null означает отсутствие измерения.

Получает RSSI / качество радиосвязи

Параметры

namestring
Filter by device name or address (substring, case-insensitive)
targetstring
CCU target to read from (default: active). See list_ccu_targets.

get_service_messagesтолько чтениевнешний мир

Получить все активные служебные сообщения (низкий заряд батареи, недоступность и т.д.) с подробной информацией об устройстве и временными метками.

Получить служебные сообщения

Параметры

targetstring
CCU target to read from (default: active). See list_ccu_targets.

get_system_infoтолько чтениевнешний мир

Получает системную информацию CCU: версию прошивки, серийный номер, адреса. Сообщает активного пользователя, вошедшего в систему, и определяемую роль (ADMIN/USER). Обратите внимание: версия/серийный номер/адреса на CCU доступны только ADMIN, поэтому при входе не-администратора (USER) они показываются как "N/A". Если CCU недоступен или не удаётся выполнить вход, вместо этого возвращается ошибка: "N/A" всегда означает "подключено, но нет разрешения". Также сообщает идентификацию сборки запущенного сервера (ветка/коммит/тег git и время сборки) в разделе build.

Получить информацию о системе

Параметры

targetstring
CCU target to read from (default: active). See list_ccu_targets.

get_valueтолько чтениевнешний мир

Читает значение одной точки данных из канала устройства. Требуются только address и valueKey — интерфейс определяется автоматически. Используйте list_devices для поиска адресов, describe_device_type для поиска допустимых valueKeys.

Получить значение

Параметры

addressstringобязательный
Channel address (e.g. '000A1BE9A71F15:1')
interfacestring
Interface name override (auto-resolved if omitted)
targetstring
CCU target to read from (default: active). See list_ccu_targets.
valueKeystringобязательный
Datapoint name (e.g. 'STATE', 'LEVEL', 'ACTUAL_TEMPERATURE')

get_valuesтолько чтениевнешний мир

Читает значения точек данных для нескольких каналов одновременно с помощью HM Script. Передайте либо список адресов каналов, либо отфильтруйте по имени комнаты или функции.

Получить значения (массово)

Параметры

channelsstring[]
Array of channel addresses to read
functionstring
Function name — read all channels in this function group
roomstring
Room name — read all channels in this room
targetstring
CCU target to read from (default: active). See list_ccu_targets.

helpтолько чтение

Контекстно-зависимая справка. Без аргументов: концептуальное руководство. Имя инструмента (например, 'set_value'): использование инструмента. Тип устройства (например, 'HmIP-eTRV-2'): возможности из кэша.

Справка

Параметры

topicstring
Tool name, device type, or omit for general guide

list_ccu_targetsтолько чтение

Перечисляет все настроенные цели CCU (профили), между которыми вы можете переключаться с помощью use_ccu — имя, хост, пользователь, защищённость/только чтение, какая активна, состояние входа. Никогда не раскрывает пароли.

Список целей CCU

Параметры

Без параметров.

list_devicesтолько чтениевнешний мир

Вывести список всех устройств с их каналами, типами и адресами. Опциональные фильтры: помещение, функция, тип, имя. Используйте этот инструмент в первую очередь, чтобы узнать адреса устройств для get_value/set_value.

Список устройств

Параметры

functionstring
Filter by function group name (exact match)
namestring
Filter by device/channel name (substring, case-insensitive)
roomstring
Filter by room name (exact match)
targetstring
CCU target to read from (default: active). See list_ccu_targets.
typestring
Filter by device type (exact match, e.g. 'HmIP-eTRV-2')

list_functionsтолько чтениевнешний мир

Выведи список всех функциональных групп (Heating, Lighting и т.д.) с назначенными им идентификаторами каналов.

List Functions

Параметры

targetstring
CCU target to read from (default: active). See list_ccu_targets.

list_interfacesтолько чтениевнешний мир

Выводит список доступных интерфейсов связи (BidCos-RF, HmIP-RF, VirtualDevices и т.д.).

Список интерфейсов

Параметры

targetstring
CCU target to read from (default: active). See list_ccu_targets.

list_linksтолько чтениевнешний мир

Выводит список прямых связей устройств (Direktverknüpfungen) — пар каналов отправитель→получатель, которые работают независимо от CCU (например, настенный выключатель напрямую управляет лампой, или термостаты, связанные с FALMOT). Только для чтения. Опционально фильтрует по связям, затрагивающим конкретное устройство или адрес канала.

Список прямых ссылок на устройства

Параметры

addressstring
Device or channel address to filter by (e.g. '000A1BE9A71F15' or '000A1BE9A71F15:1')
targetstring
CCU target to read from (default: active). See list_ccu_targets.

list_programsтолько чтениевнешний мир

Выведи все программы автоматизации. Используй execute_program, чтобы запустить их.

Список программ

Параметры

namestring
Filter by program name (substring, case-insensitive)
targetstring
CCU target to read from (default: active). See list_ccu_targets.

list_roomsтолько чтениевнешний мир

Выведи список всех комнат с назначенными идентификаторами каналов. Используй вместе с list_devices, чтобы найти устройства по комнате.

Список комнат

Параметры

targetstring
CCU target to read from (default: active). See list_ccu_targets.

list_system_variablesтолько чтениевнешний мир

Выведи все системные переменные с текущими значениями и метаданными. Используй set_system_variable, чтобы изменить их.

Список системных переменных

Параметры

namestring
Filter by variable name (substring, case-insensitive)
targetstring
CCU target to read from (default: active). See list_ccu_targets.

put_paramsetидемпотентныйвнешний мир

Записывает несколько параметров одновременно (например, недельный профиль термостата). Интерфейс определяется автоматически по адресу.

Установить Paramset

Параметры

addressstringобязательный
Channel address
confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
interfacestring
Interface name override
paramsetKeyenumобязательный
Paramset to write
setobjectобязательный
Key-value pairs to write (e.g. {TEMPERATURE_WINDOW_OPEN: 5.0})

run_scriptвнешний мир

Выполняет произвольный скрипт HomeMatic на CCU. НЕ идемпотентен: не будет автоматически повторён. Использует для всего, что не охватывают другие инструменты. На защищённой цели КАЖДЫЙ вызов требует confirm:true: разблокировка сессии из других инструментов записи не применяется.

Выполняет HomeMatic Script

Параметры

confirmboolean
Required true on EVERY call against a protected CCU target (e.g. prod) — scripts never ride on the session unlock.
scriptstringобязательный
HomeMatic Script to execute

set_system_variableидемпотентныйвнешний мир

Устанавливает значение системной переменной. Тип определяется автоматически: используйте list_system_variables для просмотра доступных переменных.

Установить системную переменную

Параметры

confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
namestringобязательный
Variable name (exact match)
valuestring | number | booleanобязательный
Value to set

set_valueидемпотентныйвнешний мир

Устанавливает значение одной точки данных (datapoint) на канале устройства (device channel). Обязательны только address, valueKey и value — interface и type определяются автоматически. Возвращает предыдущее значение для отмены. Используйте describe_device_type, чтобы найти подходящие valueKey и диапазоны.

Установить значение

Параметры

addressstringобязательный
Channel address (e.g. '000A1BE9A71F15:1')
confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
interfacestring
Interface name override (auto-resolved if omitted)
typeenum
Value type override (auto-resolved if omitted)
valuestring | number | booleanобязательный
Value to set
valueKeystringобязательный
Datapoint name (e.g. 'STATE', 'LEVEL', 'SET_POINT_TEMPERATURE')

unassign_channelидемпотентныйвнешний мир

Удаляет канал из комнаты и/или функциональной группы. Идентифицируйте канал по адресу, а комнату/функцию по имени (используйте list_rooms / list_functions для просмотра имён). Требуется указать хотя бы одну комнату или функцию.

Удалить канал из комнаты/функции

Параметры

channelstringобязательный
Channel address (e.g. '000A1BE9A71F15:1')
confirmboolean
Set true to authorize this write against a protected CCU target (e.g. prod). Unlocks writes to that target for the rest of the session.
functionstring
Function group name (exact match)
roomstring
Room name (exact match)

use_ccu

Переключает активную цель CCU. Все последующие вызовы инструментов направляются на эту цель, пока не будет выполнено переключение снова (используйте аргумент target для однократного вызова на инструментах чтения без переключения). Возвращает информацию о новом активном соединении. Вход выполняется лениво, при первом вызове.

Переключение цели CCU

Параметры

profilestringобязательный
Target name (see list_ccu_targets)

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 8
Форков на Github: 2
Загрузок: 2 253
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 09.09 в 00:13
Идентификатор: jUbzBjzE3wQzTiHg
Категории: ИИ и машинное обучение, Инструменты для разработчиков, Умный дом и IoT