# ccu-mcp

Подключает ИИ-ассистента к контроллеру HomeMatic CCU через JSON-RPC API. Помогает спрашивать про датчики, переименовывать устройства и управлять отоплением без облака и аддонов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 у репозитория
- Автор: claymore666
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/claymore666/ccu-mcp
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/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`, иначе сессия и кэш типов устройств будут создаваться заново при каждом старте.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `CCU_HOST`, `CCU_PASSWORD`, `CCU_USER`, `CCU_HTTPS`, `CCU_PORT`, `CACHE_DIR`, `MCP_ALLOWED_ORIGINS`, `MCP_ALLOWED_HOSTS`, `CCU_PROFILES`, `CCU_DEFAULT_PROFILE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- спросить у ассистента, открыты ли окна
- поменять температуру отопления в комнате
- найти устройства с севшими батареями
- переименовать каналы по единому шаблону с этажами UG/OG/EG
- узнать показания газового счётчика

## Примеры запросов агенту
- Какая температура в ванной?
- Поставь отопление в гостиной на 21 градус.
- Найди все устройства с низким зарядом батареи.

## Похожие
- [mcp-hass](https://affpapa.org/nevibecode/skills/mcp-hass.md) — скилл · 3200 установок
- [homeassistant-mcp-server](https://affpapa.org/nevibecode/skills/homeassistant-mcp-server.md) — скилл · 207 установок
- [Tapo MCP](https://affpapa.org/nevibecode/mcp/tapo-mcp.md) — MCP-сервер · ★ 877 у репозитория
- [wemo](https://affpapa.org/nevibecode/mcp/wemo.md) — MCP-сервер · ★ 56 у репозитория
- [Homebridge](https://affpapa.org/nevibecode/mcp/homebridge.md) — MCP-сервер · ★ 12 у репозитория
- [Yeelight IoT MCP Server](https://affpapa.org/nevibecode/mcp/yeelight-iot-mcp-server.md) — MCP-сервер · ★ 10 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
