ha-mcp
MCP-сервер для Home Assistant: агент читает состояние умного дома и управляет устройствами через ваш экземпляр
- 7 656 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Управляет реальными устройствами умного дома
- Работает с долгоживущим токеном доступа к Home Assistant
- Доступные пользователи делят учетные данные сервера
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ha-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет реальными устройствами умного дома
- Работает с долгоживущим токеном доступа к Home Assistant
- Доступные пользователи делят учетные данные сервера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 87 инструментов для Home Assistant: поиск и состояния сущностей (ha_search, ha_get_state), вызов сервисов и массовое управление (ha_call_service, ha_bulk_control), создание и правка автоматизаций, скриптов, сцен, помощников и дашбордов. Для отладки есть трассировки автоматизаций, история и логи, а для обслуживания резервные копии, обновления, реестры устройств и сущностей, HACS. Рекомендуемый путь установки: кастомный компонент HA-MCP через HACS, он запускает сервер внутри Home Assistant, не требует токена и выдает адрес подключения на экране настроек. Запасные пути такие: приложение (add-on) для Home Assistant OS и Supervised, Docker-образ и пакет ha-mcp из PyPI, которым нужны адрес Home Assistant и долгоживущий токен. Режим Read Only, отключение отдельных инструментов и политики подтверждения ограничивают то, что агент может менять.
Для кого. Для владельцев умного дома на Home Assistant, которые хотят управлять им через ИИ-ассистента.
Подходит, если
- Вы пишете «создай автоматизацию, которая включает свет на крыльце на закате», а агент сам собирает триггеры и действия вместо ручной правки YAML
- Датчик движения перестал запускать сценарий, и агент по трассировке автоматизации находит шаг, на котором срабатывание обрывается
- Нужен сценарий «режим кино»: агент создает скрипт, который приглушает свет, закрывает шторы и включает телевизор
- Вы ведете дашборд и хотите попросить «добавь карточку погоды», не открывая редактор Lovelace
- Нужно проверить дом перед отъездом: открытые двери, состояние сущностей и свежие резервные копии, одним запросом
Не подходит, если
- Нужно только голосовое управление уже открытыми для Assist устройствами: хватит встроенного MCP-сервера Home Assistant, он работает через Assist
- Нужен более узкий сервер без 87 инструментов: сравните Hass-MCP или Home Assistant Vibecode Agent из каталога
- Нельзя давать доступ к конфигурации дома: у ha-mcp 87 инструментов, и часть умеет удалять и перезапускать, ограничивайте их режимом Read Only
- Нет своего Home Assistant: попробовать без него можно только на демо-сервере с готовыми скриптами установки
Пример запроса к агенту
Создай в Home Assistant автоматизацию, которая включает свет на крыльце за 15 минут до заката и выключает в 23:30, а потом покажи ее трассировку за прошлые сутки, чтобы проверить срабатываниеMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
HA_URLобязательная- Адрес вашего сервера Home Assistant
HA_TOKENобязательная, секрет- Долгоживущий токен доступа Home Assistant
Ограничения
Доступ: широкий. Сервер видит все сущности Home Assistant, даже закрытые для Assist, и умеет создавать, менять и удалять автоматизации, скрипты, помощники, дашборды, зоны и устройства, делать и восстанавливать резервные копии, перезапускать систему. В вариантах с Docker и PyPI нужен долгоживущий токен, лучше администратора, токен без прав администратора работает с ограничениями. Инструменты для файлов и YAML помечены бета-версией, требуют второй записи компонента и флага ENABLE_BETA_FEATURES. Транспорт stdio README не рекомендует из-за известных проблем соединения, рабочий вариант это HTTP. Держите одну схему установки на клиента: две записи одного сервера вызывают зависания. При входе через OIDC все пользователи делят учетные данные Home Assistant сервера.
Как отключить. Остановите контейнер или процесс ha-mcp и уберите сервер из конфигурации MCP клиента, при необходимости отзовите долгоживущий токен в Home Assistant.
Частые вопросы
Это официальная интеграция Home Assistant?
Нет, авторы называют проект неофициальным MCP-сервером. У самого Home Assistant есть встроенный MCP-сервер на базе Assist: он управляет открытыми для Assist устройствами, а ha-mcp дополнительно создает автоматизации, скрипты и дашборды.
Какой транспорт выбрать?
Рекомендуется кастомный компонент или HTTP через Docker либо PyPI. У stdio есть известные проблемы соединения, поэтому README оставляет его для демо и экспериментов.
Как установить и проверить, что все работает?
Добавьте репозиторий homeassistant-ai/ha-mcp-integration в HACS как пользовательский, скачайте компонент, перезапустите Home Assistant и добавьте запись HA-MCP Server. Скопируйте адрес с экрана Configure в клиент и спросите агента, видит ли он ваш Home Assistant.
Как попробовать без своего Home Assistant?
Для macOS, Linux и Windows есть скрипты, которые настраивают stdio-подключение к демо-среде. После запуска скрипта и перезапуска Claude Desktop задайте вопрос «Can you see my Home Assistant?». Для своего дома затем следуйте ссылке Connect your own Home Assistant.
Что делать, если клиент зависает при подключении?
Проверьте, что для сервера настроена одна схема установки. Частая причина зависаний в README: локальная запись uvx с токеном и рядом адрес приложения или компонента в том же клиенте. Оставьте одну.
Как ограничить агента, чтобы он ничего не менял?
Включите Read Only Mode, отключите ненужные инструменты поштучно или задайте политики безопасности с подтверждением пользователя. Администраторская панель HA-MCP в боковом меню Home Assistant управляет инструментами, флагами и резервными копиями.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP сервер для Home Assistant: агент читает состояние устройств, управляет ими и правит дашборды умного дома
MCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации
Vibecode MCP дает Cursor, VS Code и Claude Code писать автоматизации и панели Home Assistant через аддон-агент
Home Assistant Vibecode Agent
home-assistant-vibecode-agent
Надстройка Home Assistant и сервер MCP: агент проверяет конфигурацию и применяет автоматизации. Нужен долгоживущий токен. Не официальный проект
Интеграция Home Assistant передает выбранные инструменты Xiaozhi, чтобы голосовой агент управлял доступными устройствами.
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ha-mcp (эта карточка) | нет | API-ключ | 7 656 | |
| keenetic-mcp — управление роутером Keenetic | нет | ключ необязателен | 31 | MCP-сервер для роутеров Keenetic |
| homeassistant-mcp | нет | API-ключ | 574 | MCP-сервер на Node.js |
Коротко о README
ha-mcp это неофициальный MCP-сервер для Home Assistant, дающий агенту читать состояние умного дома и управлять устройствами. Он запускается в режиме HTTP через Docker или пакет ha-mcp из PyPI и подключается к Home Assistant по адресу и долгоживущему токену. Мастер настройки собирает готовую конфигурацию под каждый клиент. Есть варианты удаленного доступа и защита входа через OIDC. Лицензия MIT.