homeassistant-ai/ha-mcp

Неофициальный и потрясающий MCP-сервер для Home Assistant

MCP⭐ 4 803Pythonпоследний релиз: v8.5.0

Что это за инструмент

ha-mcp — это сервер Model Context Protocol (MCP) для интеграции AI-ассистентов с Home Assistant, позволяющий управлять умным домом через естественный язык.

Зачем нужен

Инструмент решает задачу безопасного и удобного взаимодействия языковых моделей (LLM) с инфраструктурой Home Assistant. Он полезен тем, кто хочет автоматизировать управление устройствами, проверять состояния датчиков и управлять автоматизациями, используя интерфейсы вроде Claude Desktop или ChatGPT, без необходимости писать сложный код.

Что можно реализовать

Управление устройствами умного дома (включение света, настройка термостата) через текстовые запросы к AI-ассистенту.
Запрос текущих состояний датчиков и устройств в реальном времени.
Выполнение сервисных команд Home Assistant (например, запуск сценариев или скриптов).
Управление и просмотр списка автоматизаций (automations) через диалог с AI.

Ключевые возможности

Поддержка 95+ инструментов (tools) для широкого спектра операций с Home Assistant.
Рекомендуемый способ установки — официальный аддон для Home Assistant OS, который не требует ручного управления токенами.
Работа на базе FastMCP, что обеспечивает стандартизированное подключение к различным MCP-клиентам.
Активная разработка и регулярные релизы (подтверждено метриками активности коммитов и E2E-тестов).
Гибкость подключения: поддержка как локального запуска (stdio), так и работы внутри сети Home Assistant.

👤 Кому подойдёт: Владельцы Home Assistant, использующие AI-ассистентов (Claude, ChatGPT) для управления умным домом; разработчики, внедряющие MCP-интеграции в свои проекты.

Релизы

v8.5.0minor

🕐 5 дн назад · релиз на GitHub ↗

Обновление FastMCP 4.0.3, добавлены HTTP-эндпоинты, бэкапы шаблонов и поддержка китайского языка.

Added: Миграция на FastMCP 4.0.3 и MCP SDK 2.2.0
Added: Добавлены read-only HTTP и webhook-эндпоинты для Home Assistant
Added: Реализованы бэкап и восстановление параметров Template helper
Added: Добавлена локализация на традиционный китайский язык
Fixed: Исправлено однократное потребление одобрения при параллельных вызовах

v8.4.3patch

🕐 16 дн назад · релиз на GitHub ↗

Исправлена конвертация LLM-API схемы, устранён сбой в Anthropic и добавлена поддержка дочерних устройств Core 2026.9.

Fixed: Устранён сбой в каждом запросе к Anthropic, вызванный эксклюзивной привязкой схемы.
Fixed: Завершена конвертация схемы LLM-API внутри Home Assistant и закрыт issue #2361.
Added: Добавлена поддержка дочерних устройств и эффективных зон для Core 2026.9.
Обновлены CI-пайплайны: добавлена бета-ветка E2E и образ HA перенесён на версию 2026.9.0.

v8.4.2patch

🕐 17 дн назад · релиз на GitHub ↗

Исправлено зависание системы при запуске из-за логгера и исправлена работа списка разрешённых ресурсов.

Fixed: Устранено зависание Home Assistant, вызванное работой StartupLogCollector.
Fixed: Исправлено игнорирование правил авторизации для allowlist.
Added: Обновлена настройка коннектора Claude.ai для работы с новым мастером конфигурации.

v8.4.1patch

🕐 19 дн назад · релиз на GitHub ↗

Исправлена работа OAuth, ускорен отклик при недоступных сервисах, улучшены описания параметров и поиск тарифов.

Fixed: OAuth теперь отдает документ защищенного ресурса только по его специфичному пути.
Fixed: Система быстро завершает работу при обращении к несуществующим или недоступным целям ha_call_service.
Fixed: Исправлено извлечение описаний параметров для bare Annotated-подписей инструментов.
Added: Улучшен поиск: повышен приоритет ha_manage_energy_prefs при запросах тарифов и цен.
Added: Добавлены описания параметров для ha_call_service и оптимизирован файл AGENTS.md.

v8.4.0minor

🕐 22 дн назад · релиз на GitHub ↗

Добавлены кляйнский и корейский языки, улучшен поиск через граф ссылок, исправлены ошибки скриншотов и логов.

Added: Добавлена локализация на кляйнский и корейский языки.
Added: Поиск использует граф ссылок Home Assistant для обнаружения зависимостей сущностей.
Added: Включены детерминированные структурные селекторы для пакетного управления.
Fixed: Исправлены размеры скриншотов пользовательских панелей и ошибки логирования.
Fixed: Устранены проблемы с таймаутами, TLS-настройками и восстановлено управление приложениями Supervisor.

v8.3.0minor

🕐 1 мес назад · релиз на GitHub ↗

Релиз v8.3.0: поддержка Hermes Agent, новые локали, улучшенный OAuth и инструменты для управления приложениями.

Added: Добавлена поддержка агента Hermes в мастер-установке.
Added: Переименованы инструменты управления приложениями в ha_get_app и ha_manage_app.
Added: Добавлены переводы интерфейса на чешский (cs) и эсперанто (eo).
Added: Реализован структурированный режим сводки для получения логов ошибок.
Fixed: Исправлена работа с прозрачными токенами доступа в режиме OIDC.
Fixed: Устранены ошибки при обработке нулевых состояний триггеров в трассировках автоматизации.

v8.2.0minor

🕐 1 мес назад · релиз на GitHub ↗

Релиз v8.2.0: добавлены новые языки, инструменты управления HACS и политиками безопасности, а также исправления багов.

Added: Добавлена поддержка шведского, польского и нидерландского языков во всех интерфейсах.
Added: Появились инструменты для управления обновлениями HACS и политиками безопасности.
Added: Добавлена функция скрытия конфиденциальных данных в ответах инструментов.
Fixed: Исправлены ошибки маршрутизации, валидации ссылок и обработки локалей.

v8.1.1patch

🕐 1 мес назад · релиз на GitHub ↗

Исправлено использование веб-сокетов и устранено принудительное перезаписывание пакетов Home Assistant.

Fixed: Исправлено использование веб-сокетов и устранено принудительное перезаписывание пакетов Home Assistant.
Fixed: Исправлено наименование предложения 409 в каталоге.
Fixed: Устранена неточность в документации по добавлению нового языка.

v8.1.0minor

🕐 1 мес назад · релиз на GitHub ↗

Релиз v8.1.0: добавлены ссылки на мастер установки, улучшена стабильность и документация безопасности.

Added: Появились ссылки для совместного доступа к мастеру настройки (setup wizard).
Added: Машинный перевод теперь применяется после слияния кода, а не в рамках pull request.
Fixed: Исправлена работа меню с повторными выборами и стабильность URL sidecar-настроек.
Fixed: Улучшена корректность завершения задач при остановке и отмене фоновых процессов.
Added: В SECURITY.md обновлена документация по свойствам доверия Webhook Proxy и OIDC.

v8.0.0majorbreaking

🕐 1 мес назад · релиз на GitHub ↗

Релиз v8.0.0: новые локали, переработка безопасности инструментов, исправления стабильности и миграция с SSE.

Added: Добавлены переводы на итальянский, испанский и упрощенный китайский языки.
Breaking: Удален устаревший entry point ha-mcp-sse.
Added: Переработана семантика политики безопасности инструментов и добавлен режим принудительного контроля видимости сущностей.
Fixed: Исправлено сохранение настроек Docker при пересоздании контейнера и улучшена обработка ошибок в пакетных операциях.
Added: В OAuth-ответы добавлен параметр iss в соответствии с RFC 9207.

v7.11.0minor

🕐 2 мес назад · релиз на GitHub ↗

Обновление сущностей, уведомления об автообновлениях, исправление зависания WebSocket и отображения страницы.

Added: Добавлено обновление сущностей сервера, уведомления об автообновлениях и реальные заметки о выпусках HACS.
Fixed: Исправлено зависание вызовов инструментов: теперь корректно обрабатывается закрытие WebSocket.
Fixed: На странице входа MCP-эндпоинта встроенного сервера теперь отображается посадочная страница браузера.

v7.10.0minor

🕐 2 мес назад · релиз на GitHub ↗

Релиз v7.10.0: запуск автономного сервера ha_mcp_server, поддержка Matter/Thread и новые инструменты управления радио.

Added: Добавлен автономный сервер ha_mcp_server как кастомная интеграция с возможностью самодообновления.
Added: Реализована поддержка Matter и Thread, а также унифицированный инструмент управления радио ha_manage_radio.
Added: Внедрен фильтр видимости сущностей для инструментов чтения коллекций (opt-in).
Fixed: Исправлена порча контента в ha_config_set_yaml, добавлен предпросмотр изменений и подтверждение.
Fixed: Устранены проблемы с доступностью HTTP-серверов и валидацией аргументов в fastmcp 3.4.3.

v7.9.0minor

🕐 2 мес назад · релиз на GitHub ↗

Релиз v7.9.0: улучшена работа с бэкапами, добавлена поддержка KNX, исправлены ошибки восстановления и логирования.

Added: Автоматическое создание бэкапов при записи файлов и YAML-конфигураций
Added: Добавлена поддержка адресов групп KNX в инструменте ha_get_integration
Added: Включено уведомление о доступности новых версий ha-mcp
Fixed: Исправлено ожидание защитного бэкапа и передача пароля при восстановлении снимков
Fixed: Устранена проблема с пропуском создания бэкапов на некоторых путях записи