claymore666/debmatic-mcp

claymore666/debmatic-mcp

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

ccu-mcp

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

ccu-mcp MCP server

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?"
acknowledge_service_messagesидемпотентныйвнешний мир

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

Acknowledge Service Messages

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

Параметры

  • idstring

    Alarm id from get_service_messages (confirm a single message)

  • 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.

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

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

Assign Channel to Room/Function

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

Параметры

  • channelstringобязательный

    Channel address (e.g. '000A1BE9A71F15:1')

  • roomstring

    Room name (exact match)

  • functionstring

    Function group name (exact match)

  • 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.

create_system_variableвнешний мир

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

Create System Variable

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

Параметры

  • namestringобязательный

    New variable name (must not already exist)

  • typeenumобязательный

    Variable type

    boolfloatenumstring
  • descriptionstring

    Human-readable description shown in the WebUI

  • unitstring

    Unit label (float only, e.g. '°C')

  • minnumber

    Minimum value (float only)

  • maxnumber

    Maximum value (float only)

  • valuesstring[]

    Enum value labels in order (enum only, e.g. ['off','low','high'])

  • 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.

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

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

Delete System Variable

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

Параметры

  • namestringобязательный

    Variable name (exact match)

  • confirmboolean

    Required true on EVERY call against a protected CCU target (e.g. prod) — deletion never rides on the session unlock.

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

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

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 программ.

Execute Program

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

Параметры

  • idstringобязательный

    Program ID. Get from list_programs.

  • 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.

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

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

Get Connection Info

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

Параметры

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

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

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

Get Paramset

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

Параметры

  • addressstringобязательный

    Channel address (e.g. '000A1BE9A71F15:1')

  • paramsetKeystringобязательный

    'VALUES', 'MASTER', or a link partner's channel address (reads that direct link's parameters)

  • interfacestring

    Interface name override (auto-resolved if omitted)

  • 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 означает отсутствие измерения.

Get RSSI / Radio Quality

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

Параметры

  • 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только чтениевнешний мир

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

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". Также сообщает идентификацию сборки запущенного сервера (ветка git/коммит/тег и время сборки) в `build`.

Get System Info

Получает системную информацию CCU: версию прошивки, серийный номер, адреса. Сообщает активного пользователя и предполагаемую роль (ADMIN/USER) — обратите внимание: версия/серийный номер/адреса на CCU доступны только ADMIN, поэтому для неадминистративного входа (USER) они отображаются как "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.

Get Value

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

Параметры

  • addressstringобязательный

    Channel address (e.g. '000A1BE9A71F15:1')

  • valueKeystringобязательный

    Datapoint name (e.g. 'STATE', 'LEVEL', 'ACTUAL_TEMPERATURE')

  • interfacestring

    Interface name override (auto-resolved if omitted)

  • targetstring

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

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

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

Get Values (Bulk)

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

Параметры

  • channelsstring[]

    Array of channel addresses to read

  • roomstring

    Room name — read all channels in this room

  • functionstring

    Function name — read all channels in this function group

  • targetstring

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

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

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

Help

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

Параметры

  • topicstring

    Tool name, device type, or omit for general guide

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

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

List CCU Targets

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

Параметры

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

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

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

List Devices

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

Параметры

  • roomstring

    Filter by room name (exact match)

  • functionstring

    Filter by function group name (exact match)

  • typestring

    Filter by device type (exact match, e.g. 'HmIP-eTRV-2')

  • namestring

    Filter by device/channel name (substring, case-insensitive)

  • targetstring

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

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

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

List Functions

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

Параметры

  • targetstring

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

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

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

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). Только для чтения. Опционально фильтрует по связям, затрагивающим конкретное устройство или адрес канала.

List Direct Device 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, чтобы запустить их.

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, чтобы найти устройства по комнате.

List Rooms

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

Параметры

  • targetstring

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

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

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

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идемпотентныйвнешний мир

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

Put Paramset

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

Параметры

  • addressstringобязательный

    Channel address

  • paramsetKeyenumобязательный

    Paramset to write

    VALUESMASTER
  • setobjectобязательный

    Key-value pairs to write (e.g. {TEMPERATURE_WINDOW_OPEN: 5.0})

  • interfacestring

    Interface name override

  • 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.

run_scriptвнешний мир

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

Run HomeMatic Script

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

Параметры

  • scriptstringобязательный

    HomeMatic Script to execute

  • confirmboolean

    Required true on EVERY call against a protected CCU target (e.g. prod) — scripts never ride on the session unlock.

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

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

Set System Variable

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

Параметры

  • namestringобязательный

    Variable name (exact match)

  • valueanyобязательный

    Value to set

  • 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.

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

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

Set Value

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

Параметры

  • addressstringобязательный

    Channel address (e.g. '000A1BE9A71F15:1')

  • valueKeystringобязательный

    Datapoint name (e.g. 'STATE', 'LEVEL', 'SET_POINT_TEMPERATURE')

  • valueanyобязательный

    Value to set

  • interfacestring

    Interface name override (auto-resolved if omitted)

  • typeenum

    Value type override (auto-resolved if omitted)

    boolintdoublestring
  • 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.

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

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

Remove Channel from Room/Function

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

Параметры

  • channelstringобязательный

    Channel address (e.g. '000A1BE9A71F15:1')

  • roomstring

    Room name (exact match)

  • functionstring

    Function group name (exact match)

  • 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.

use_ccu

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

Switch CCU Target

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

Параметры

  • profilestringобязательный

    Target name (see list_ccu_targets)

Другие проверенные MCP-сервера

weaviate/mcp-server-weaviate

weaviate/mcp-server-weaviate

официальный

Встроенный MCP сервер Weaviate даёт AI-агентам гибридный поиск, управление коллекциями и объектами прямо через REST API. Полезен разработчикам, работающим с векторными базами данных.

162
snyk/studio-mcp

snyk/studio-mcp

официальный

MCP-сервер Snyk интегрирует сканирование безопасности в AI-инструменты. Запускает SCA, SAST, IaC-проверки и возвращает уязвимости. Полезен для DevSecOps-пайплайнов. Управляется через `snyk mcp`.

Go53
microsoft/azure-devops-mcp

microsoft/azure-devops-mcp

MCP сервер для Azure DevOps предоставляет AI-агентам доступ к проектам, рабочим элементам и вики. Рекомендуется удаленная версия, доступна и локальная. Инструмент упрощает взаимодействие с DevOps-данными через естественный язык.

TypeScript1895
base/base-mcp

base/base-mcp

официальный

MCP-сервер для интеграции AI-агентов с сетью Base. Репозиторий устарел. Используйте новые quickstart по платежам и торговле из документации Base AI Agents. Подходит разработчикам, создающим автомат...

TypeScript353
Aas-ee/open-webSearch

Aas-ee/open-webSearch

open-websearch — это MCP-сервер и CLI для веб-поиска и извлечения контента без API-ключей. Поддерживает множество поисковиков (Bing, Baidu, DuckDuckGo и др.), загружает статьи и README с GitHub. Ра...

TypeScript1615
MarkusPfundstein/mcp-obsidian

MarkusPfundstein/mcp-obsidian

MCP сервер для Obsidian через плагин Local REST API даёт инструменты для работы с хранилищем: чтение, поиск и изменение файлов. Идеально для интеграции заметок с AI-помощниками и автоматизации.

Python4102
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин