hass-mcp

hass-mcp — MCP-сервер сообщества (автор — voska). Управление умным домом в Home Assistant: устройства, состояния и автоматизации. Ставится через Docker или через uvx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
voska
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
python

Уровень риска: high

Управляет устройствами и службами Home Assistant, может перезапустить его; долгосрочный токен даёт полный доступ; HTTP-режим без встроенной аутентификации.

Настройка клиентов

cursor
{
    "code": "docker run -i --rm -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOUR_LONG_LIVED_TOKEN voska/hass-mcp",
    "lang": "bash",
    "notes": "Команда для формы Settings > MCP > Add New MCP Server, тип command",
    "verified": "docs"
}

Что умеет

Hass-MCP — MCP-сервер для Home Assistant под лицензией MIT. Он позволяет Claude и другим ИИ-ассистентам работать с вашим экземпляром Home Assistant напрямую: узнавать состояние устройств и датчиков, управлять светом, выключателями и другими сущностями, разбираться с автоматизациями и редактировать панели Lovelace. Ответы компактные, чтобы экономить токены.

Инструменты по README:

  • сущности: состояние (get_entity), список с фильтром по домену, поиск, сводка по домену, сущности по комнате;
  • управление: entity_action (включить, выключить, переключить), call_service_tool — вызов любой службы Home Assistant, restart_ha — перезапуск Home Assistant;
  • автоматизации: список автоматизаций и помощь в их отладке;
  • история и статистика: история состояний за последние часы или за период, долгосрочная статистика (среднее, минимум, максимум);
  • журнал ошибок с фильтрами по уровню, интеграции и строке поиска;
  • панели Lovelace: чтение и правка карточек и видов через WebSocket API. Изменения сразу видны в открытых браузерах, перед каждой записью создаётся резервная копия, а параметр dry_run=true показывает результат без сохранения.

Есть готовые подсказки (create_automation, debug_automation, automation_health_check и другие) и ресурсы вида hass://entities.

Кому подойдёт

  • Владельцам умного дома на Home Assistant, которые хотят управлять устройствами и разбирать автоматизации на естественном языке.
  • Тем, кто настраивает панели: ассистент может собрать или перестроить панель Lovelace с предпросмотром изменений.

Похожие серверы — в категории автоматизация и IoT.

Установка

Нужны экземпляр Home Assistant с долгосрочным токеном доступа и Docker (рекомендуется) либо Python 3.13+ с uv. Образ Docker:

docker pull voska/hass-mcp:latest

Сервер настраивается переменными HA_URL (адрес Home Assistant) и HA_TOKEN (долгосрочный токен). Если Home Assistant работает на той же машине, в Docker Desktop для Mac и Windows используйте адрес http://host.docker.internal:8123. Для экземпляров с собственным центром сертификации укажите SSL_CERT_FILE — отключить проверку TLS нельзя намеренно.

Для шлюзов и сетевых клиентов есть режим потокового HTTP (uvx hass-mcp --http --port 8000), конечная точка — /mcp. По умолчанию сервер слушает только 127.0.0.1.

Подключение к клиентам

Конфиги приведены дословно из README. Замените YOUR_LONG_LIVED_TOKEN на свой токен и укажите адрес своего Home Assistant. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "http://homeassistant.local:8123",
        "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
      }
    }
  }
}

Для Claude Desktop конфиг добавляют в claude_desktop_config.json (Settings → Developer → Edit Config) и перезапускают приложение. В Cursor команду вводят в форме Settings → MCP → Add New MCP Server с типом command. В README есть и вариант для Claude Desktop через uvx hass-mcp.

Проверка

Спросите ассистента: «Какая версия Home Assistant?» или «Какое состояние у света в гостиной?». Затем попробуйте безопасный запрос к журналу: «Покажи последние 50 строк ERROR из журнала Home Assistant».

Примеры задач

Выключи весь свет на кухне и покажи, какие сущности остались включёнными.
Помоги разобраться, почему не срабатывает автоматизация с датчиком движения в спальне, и покажи историю датчика за вчера.

Риски

  • Управление домом. Ассистент может включать и выключать устройства, вызывать любые службы Home Assistant (в том числе замки и сигнализацию, если они подключены) и перезапускать Home Assistant. Проверяйте такие вызовы перед подтверждением.
  • Токен. Долгосрочный токен даёт полный доступ к Home Assistant, а для правки панелей нужен токен администратора. Храните его в переменных окружения и не публикуйте конфиги.
  • HTTP-режим. README прямо предупреждает: в HTTP-режиме любой, кто достучится до порта, может вызвать любой инструмент — выключить свет, открыть двери, перезапустить Home Assistant. Встроенной аутентификации нет; используйте обратный прокси с проверкой, VPN или оставьте привязку к 127.0.0.1.
  • Правка панелей. Каждое изменение перезаписывает конфигурацию панели целиком. Резервные копии хранятся в ~/.hass-mcp/dashboard-backups/; в Docker смонтируйте том, иначе они пропадут вместе с контейнером.

Частые вопросы

Можно ли редактировать панели в режиме YAML?

Нет. Править можно только панели, управляемые через интерфейс; YAML-панели сервер распознаёт и отклоняет с понятным сообщением.

Как откатить неудачную правку панели?

Инструменты list_dashboard_backups и restore_dashboard показывают автоматические копии и восстанавливают нужную.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

commands

Сервер из UI-TARS-desktop для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники