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

claymore666/debmatic-mcp

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

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

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

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?"

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

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

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

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

Параметры

addressstring
Адрес канала: подтверждает все активные сообщения на этом канале (например, '000A1BE9A71F15:0')
confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
idstring
Идентификатор тревоги из get_service_messages (подтвердите одно сообщение).

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

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

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

Параметры

channelstringобязательный
Адрес канала (например, '000A1BE9A71F15:1')
confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
functionstring
Имя группы функций (точное совпадение)
roomstring
Название комнаты (точное совпадение)

create_system_variableвнешний мир

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

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

Параметры

confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
descriptionstring
Человекочитаемое описание, отображаемое в WebUI.
maxnumber
Максимальное значение (только float)
minnumber
Минимальное значение (только float)
namestringобязательный
Новое имя переменной (не должно уже существовать)
typeenumобязательный
Тип переменной
unitstring
Подпись единицы измерения (только для float, например '°C')
valuesstring[]
Подписи значений перечисления по порядку (только для enum, например ['off','low','high'])

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

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

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

Параметры

confirmboolean
Обязательно true при КАЖДОМ вызове к защищённой цели CCU (например, прод) - удаление никогда не зависит от разблокировки сессии.
namestringобязательный
Имя переменной (точное совпадение)

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

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

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

Параметры

deviceTypestringобязательный
Название типа устройства (например, 'HmIP-eTRV-2', 'HmIP-SWDO-I'). Возьмите из list_devices.
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

execute_programвнешний мир

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

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

Параметры

confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
idstringобязательный
Идентификатор программы. Получите из list_programs.

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

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

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

Параметры

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

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

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

Get Paramset

Параметры

addressstringобязательный
Адрес канала (например, '000A1BE9A71F15:1')
interfacestring
Переопределение имени интерфейса (если не указано, определяется автоматически)
paramsetKeystringобязательный
'VALUES', 'MASTER' или адрес канала партнера по ссылке (читает параметры этой прямой ссылки).
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

namestring
Фильтр по имени устройства или адресу (подстрока, без учёта регистра)
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

addressstringобязательный
Адрес канала (например, '000A1BE9A71F15:1')
interfacestring
Переопределение имени интерфейса (если не указано, определяется автоматически)
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.
valueKeystringобязательный
Имя точки данных (например, 'STATE', 'LEVEL', 'ACTUAL_TEMPERATURE')

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

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

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

Параметры

channelsstring[]
Массив адресов каналов для чтения.
functionstring
Имя функции: читает все каналы в этой группе функций.
roomstring
Название комнаты: читает все каналы в этой комнате.
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

Справка

Параметры

topicstring
Название инструмента, тип устройства или оставьте поле пустым для общего руководства.

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

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

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

Параметры

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

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

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

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

Параметры

functionstring
Фильтровать по имени группы функций (точное совпадение)
namestring
Фильтрует по имени устройства/канала (подстрока, без учёта регистра).
roomstring
Фильтровать по имени комнаты (точное совпадение)
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.
typestring
Фильтрует по типу устройства (точное совпадение, например, 'HmIP-eTRV-2')

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

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

List Functions

Параметры

targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

addressstring
Адрес устройства или канала для фильтрации (например, '000A1BE9A71F15' или '000A1BE9A71F15:1')
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

namestring
Фильтр по имени программы (подстрока, без учёта регистра)
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

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

Параметры

namestring
Фильтрует по имени переменной (подстрока, без учёта регистра).
targetstring
Цель CCU, из которой выполняется чтение (по умолчанию: active). См. list_ccu_targets.

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

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

Установить Paramset

Параметры

addressstringобязательный
Адрес канала
confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
interfacestring
Переопределение имени интерфейса
paramsetKeyenumобязательный
Параметры для записи.
setobjectобязательный
Пары «ключ-значение» для записи (например, {TEMPERATURE_WINDOW_OPEN: 5.0})

run_scriptвнешний мир

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

Выполняет HomeMatic Script

Параметры

confirmboolean
Требуется передавать true при КАЖДОМ вызове защищенной цели CCU (например, прод): скрипты никогда не полагаются на разблокировку сессии.
scriptstringобязательный
Скрипт HomeMatic для выполнения

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

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

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

Параметры

confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
namestringобязательный
Имя переменной (точное совпадение)
valuestring | number | booleanобязательный
Значение для установки

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

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

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

Параметры

addressstringобязательный
Адрес канала (например, '000A1BE9A71F15:1')
confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
interfacestring
Переопределение имени интерфейса (если не указано, определяется автоматически)
typeenum
Переопределение типа значения (если не указано, определяется автоматически).
valuestring | number | booleanобязательный
Значение для установки
valueKeystringобязательный
Имя точки данных (например, 'STATE', 'LEVEL', 'SET_POINT_TEMPERATURE')

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

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

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

Параметры

channelstringобязательный
Адрес канала (например, '000A1BE9A71F15:1')
confirmboolean
Установите значение true, чтобы разрешить запись в защищённую цель CCU (например, prod). Это разблокирует запись в эту цель на оставшуюся часть сессии.
functionstring
Имя группы функций (точное совпадение)
roomstring
Название комнаты (точное совпадение)

use_ccu

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

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

Параметры

profilestringобязательный
Имя цели (см. list_ccu_targets)

`1.11.4`основная	07.10.2026
`1.11.3`	30.09.2026
`1.11.2`	22.09.2026
`1.11.1`	08.09.2026
`1.11.0`	02.09.2026
`1.10.0`	19.08.2026
`1.9.1`	01.08.2026
`1.9.0`	31.07.2026
`1.8.1`	28.07.2026
`1.8.0`	05.07.2026
`1.7.0`	04.07.2026
`1.6.0`	02.07.2026
`1.5.0`	19.06.2026

Выберите клиент, чтобы установить claymore666/debmatic-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"claymore666-debmatic-mcp-ufaht9r65b\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"ccu-mcp\",\"--stdio\"],\"env\":{\"CCU_HOST\":\"your-ccu-hostname-or-ip\",\"CCU_PASSWORD\":\"your-ccu-admin-password\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add claymore666-debmatic-mcp-ufaht9r65b --env CCU_HOST=your-ccu-hostname-or-ip --env CCU_PASSWORD=your-ccu-admin-password -- npx ccu-mcp --stdio

Либо через JSON-конфиг:

claude mcp add-json claymore666-debmatic-mcp-ufaht9r65b "{\"command\":\"npx\",\"args\":[\"ccu-mcp\",\"--stdio\"],\"env\":{\"CCU_HOST\":\"your-ccu-hostname-or-ip\",\"CCU_PASSWORD\":\"your-ccu-admin-password\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add claymore666-debmatic-mcp-ufaht9r65b --env CCU_HOST=your-ccu-hostname-or-ip --env CCU_PASSWORD=your-ccu-admin-password -- npx ccu-mcp --stdio

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.claymore666-debmatic-mcp-ufaht9r65b]
command = "npx"
args = ["ccu-mcp", "--stdio"]

[mcp_servers.claymore666-debmatic-mcp-ufaht9r65b.env]
CCU_HOST = "your-ccu-hostname-or-ip"
CCU_PASSWORD = "your-ccu-admin-password"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите claymore666/debmatic-mcp, а в поле команды запуска — строку ниже:

npx ccu-mcp --stdio

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например claymore666-debmatic-mcp-ufaht9r65b.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: claymore666-debmatic-mcp-ufaht9r65b
    command: npx
    args:
      - "ccu-mcp"
      - "--stdio"
    env:
      CCU_HOST: your-ccu-hostname-or-ip
      CCU_PASSWORD: your-ccu-admin-password

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

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

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

Нужен npx

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

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