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-режим без встроенной аутентификации.
Настройка клиентов
{
"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 для запуска произвольных команд.
Windows-MCP
Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.
agent-device
Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.
MCP-сервер для анализа сбоев в WinDbg
Анализ аварийных дампов Windows через WinDbg и CDB.