ccu-mcp — MCP-сервер для HomeMatic CCU: управление умным домом из Claude Code
Подключает ИИ-ассистента к контроллеру HomeMatic CCU через JSON-RPC API. Помогает спрашивать про датчики, переименовывать устройства и управлять отоплением без облака и аддонов.
MIT ★ 9 обновлён 2026-10-21
claude mcp add --env CCU_HOST=<CCU_HOST> --env CCU_PASSWORD=<CCU_PASSWORD> --env CCU_USER=<CCU_USER> --env CCU_HTTPS=<CCU_HTTPS> --env CCU_PORT=<CCU_PORT> --transport stdio ccu-mcp -- npx -y ccu-mcpЧто делает ccu-mcp
Сервер отдаёт устройства, комнаты, программы и системные переменные CCU как инструменты MCP. Ассистент видит датчики температуры, окна, батареи и счётчики и может менять их значения. Работает через штатный эндпоинт /api/homematic.cgi, поэтому подходит для CCU3, debmatic и OpenCCU.
Сервер сам занимается обнаружением устройств, резолвом типов, сессиями и конвертацией значений. Вам остаётся только спросить, какая температура в ванной или какие окна открыты. Для запуска нужен Node.js 24+ или Docker, а также логин и пароль администратора CCU.
В stdio-режиме кэш по умолчанию пишется в /data, поэтому вне Docker он не сохраняется между запусками. Стоит сразу задать CACHE_DIR вроде $HOME/.cache/ccu-mcp, иначе сессия и кэш типов устройств будут создаваться заново при каждом старте.
Какие задачи решает
- спросить у ассистента, открыты ли окна
- поменять температуру отопления в комнате
- найти устройства с севшими батареями
- переименовать каналы по единому шаблону с этажами UG/OG/EG
- узнать показания газового счётчика
Примеры запросов агенту
- Какая температура в ванной?
- Поставь отопление в гостиной на 21 градус.
- Найди все устройства с низким зарядом батареи.
Как установить ccu-mcp
Командой платформы
claude mcp add --env CCU_HOST=<CCU_HOST> --env CCU_PASSWORD=<CCU_PASSWORD> --env CCU_USER=<CCU_USER> --env CCU_HTTPS=<CCU_HTTPS> --env CCU_PORT=<CCU_PORT> --transport stdio ccu-mcp -- npx -y ccu-mcpВместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Командой платформы
codex mcp add ccu-mcp --env CCU_HOST=<CCU_HOST> --env CCU_PASSWORD=<CCU_PASSWORD> --env CCU_USER=<CCU_USER> --env CCU_HTTPS=<CCU_HTTPS> --env CCU_PORT=<CCU_PORT> -- npx -y ccu-mcpВместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>",
"CCU_USER": "<CCU_USER>",
"CCU_HTTPS": "<CCU_HTTPS>",
"CCU_PORT": "<CCU_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"ccu-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>",
"CCU_USER": "<CCU_USER>",
"CCU_HTTPS": "<CCU_HTTPS>",
"CCU_PORT": "<CCU_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e CCU_HOST=<CCU_HOST> -e CCU_PASSWORD=<CCU_PASSWORD> -e CCU_USER=<CCU_USER> -e CCU_HTTPS=<CCU_HTTPS> -e CCU_PORT=<CCU_PORT> ccu-mcp npx -y ccu-mcpВместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ccu-mcp
Как установить ccu-mcp в Claude Code?
Выполните claude mcp add ccu-mcp -e CCU_HOST=<CCU_HOST> -e CCU_PASSWORD=<CCU_PASSWORD> -- npx -y ccu-mcp, подставив адрес и пароль вашего CCU. После этого перезапустите Claude Code и проверьте подключение командой /mcp.
Что делает ccu-mcp?
Связывает ИИ-ассистента с контроллером HomeMatic CCU через JSON-RPC API. Ассистент получает доступ к устройствам, комнатам, программам и переменным и может читать их состояние или менять значения.
Чем отличается stdio-режим от Docker?
В stdio-режиме сервер запускается как дочерний процесс вашего MCP-клиента, без сети и токенов. Docker-вариант работает как отдельный HTTP-сервер, к которому могут подключаться несколько клиентов, но требует токен и настройку MCP_ALLOWED_HOSTS.