ha-mcp
MCP-сервер для Home Assistant: агент читает состояние умного дома и управляет устройствами через ваш экземпляр
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Управляет реальными устройствами умного дома
- Работает с долгоживущим токеном доступа к Home Assistant
- Доступные пользователи делят учетные данные сервера
Установка
Ручная установка
uvx ha-mcp@latestЗапуск сервера в режиме streamable HTTP из пакета PyPI. Нужны адрес Home Assistant и токен.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ha-mcp подключает ИИ-агента к вашему серверу Home Assistant по протоколу MCP. Агент видит устройства, сущности и их состояние, вызывает сервисы и управляет умным домом на естественном языке. Сервер запускается в режиме HTTP через Docker или пакет из PyPI, указывает на адрес Home Assistant и долгоживущий токен и подключается к клиенту по секретному URL. Для удаленного доступа предусмотрены отдельные пути, а вход можно закрыть за внешним провайдером OIDC.
Для кого. Для владельцев умного дома на Home Assistant, которые хотят управлять им через ИИ-ассистента.
Подходит, если
- Нужно управлять устройствами Home Assistant голосом или из чата агента
- Нужно, чтобы агент видел состояние сущностей и вызывал сервисы
- Нужен удаленный доступ к дому через агента с защитой доступа
Не подходит, если
- Нет своего сервера Home Assistant
- Нельзя выдать долгоживущий токен доступа
- Нужно только чтение публичных данных, а не управление домом
Пример запроса к агенту
Выключи свет в гостиной и покажи, какие двери сейчас открытыОграничения
Нужны экземпляр Home Assistant и долгоживущий токен. Рекомендуется транспорт streamable HTTP: у stdio есть известные проблемы соединения. Все аутентифицированные пользователи при доступе делят учетные данные Home Assistant сервера.
Как отключить. Остановите контейнер или процесс ha-mcp и уберите сервер из конфигурации MCP клиента, при необходимости отзовите долгоживущий токен в Home Assistant.
MCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| HA_URL обязательная | Адрес вашего сервера Home Assistant |
| HA_TOKEN обязательная, секрет | Долгоживущий токен доступа Home Assistant |
Проверка безопасности
- Управляет реальными устройствами умного дома
- Работает с долгоживущим токеном доступа к Home Assistant
- Доступные пользователи делят учетные данные сервера
Коротко о README
ha-mcp это неофициальный MCP-сервер для Home Assistant, дающий агенту читать состояние умного дома и управлять устройствами. Он запускается в режиме HTTP через Docker или пакет ha-mcp из PyPI и подключается к Home Assistant по адресу и долгоживущему токену. Мастер настройки собирает готовую конфигурацию под каждый клиент. Есть варианты удаленного доступа и защита входа через OIDC. Лицензия MIT.
Частые вопросы
Это официальная интеграция Home Assistant?
Нет, авторы называют проект неофициальным MCP-сервером для Home Assistant.
Какой транспорт выбрать?
Рекомендуется streamable HTTP через Docker или PyPI. У stdio есть известные проблемы соединения, он оставлен для демо.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub