AIKraft/MCP-серверы/io.github.homeassistant-ai/ha-mcp

io.github.homeassistant-ai/ha-mcp

Комплексный сервер Model Context Protocol для управления Home Assistant через ИИ-ассистентов.

HAhomeassistant-ai Локальный · pypi Инфраструктура official ★ 5.4k

Что это

Комплексный сервер Model Context Protocol для управления Home Assistant через ИИ-ассистентов.

Как подключить

1Официальный package
pypi · ha-mcp==9.1.0
2Установить и запустить в терминале
uvx ha-mcp==9.1.0
3Добавить в конфиг MCP-клиента (mcp.json / claude_desktop_config.json)
{ "mcpServers": { "io-github-homeassistant-ai-ha-mcp": { "command": "uvx", "args": [ "ha-mcp==9.1.0" ] } } }

Вставьте блок в конфиг клиента (Claude Desktop, Claude Code, Cursor, VS Code, Cline). Команда и package собраны из полей официального MCP Registry.

Что нового в версиях

v9.1.17 ноября 2026 г.

Исправления работы конфигурации, бэкапов календаря и UI; обновление документации коннектора ChatGPT.

  • ИсправленоИсправлено открытие потока опций при чтении записи конфигурации.
  • ИсправленоВ Core 2026.11 восстановлено удаление событий календаря при бэкапе.
  • ИсправленоИсправлено выравнивание карточек ожидания одобрения в интерфейсе настроек.
  • ИсправленоУстранена ошибка обработки неизвестных параметров и обновлено поведение при отказе инструментов.
  • НовоеДобавлена документация по шагам обновления списка инструментов для коннектора ChatGPT.
v9.1.04 ноября 2026 г.

Поддержка Home Assistant 2026.11, IPv6, локаль на венгерском, исправления безопасности и стабильности.

  • НовоеДобавлена поддержка Home Assistant 2026.11, включая новые функции Marketplace и LLM API.
  • НовоеРеализована поддержка IPv6 для приложения и встроенного сервера в локальной сети.
  • НовоеДобавлена локализация на венгерский язык (hu).
  • ИсправленоИсправлена ошибка авторизации (503) при использовании TLS на стороне Home Assistant.
  • ИсправленоУстранена уязвимость: запрещены команды управления учетными записями через необработанные интерфейсы.
v9.0.028 октября 2026 г.

Релиз v9.0.0: усиление безопасности, новые функции управления бэкапами и историей, исправления видимости и восстановления.

  • НовоеДобавлен переключатель для управления доступом к встроенному серверу и возможность запуска с токеном администратора.
  • НовоеБэкапы теперь сохраняются в стандартную директорию Home Assistant, а в ha_get_history добавлен режим сводки по состояниям.
  • НовоеВнедрена настройка custom_instructions для пользовательских инструкций сервера и улучшена работа с логами.
  • ИсправленоИсправлено восстановление сущностей, скрытие скрытых элементов и отказ от перезагрузки во время обновления базы данных.
  • ИсправленоУстранены проблемы с OAuth-редиректами, привязкой токенов и корректной обработкой записей интеграции.
v8.7.014 октября 2026 г.Ломает совместимость

Ревизия архитектуры кода, отказ от бинарников, поддержка HA 2026.10 и новые возможности поиска и политик.

  • Ломает совместимостьУдалены автономные бинарные файлы и формат .mcpb; теперь требуется использование uvx или Docker.
  • НовоеДобавлена поддержка Home Assistant 2026.10, включая обнаружение MCP, метаданные инструментов и переключатель использования имени устройства.
  • НовоеУлучшен поиск по дашбордам: теперь можно находить карточки, вложенные в пользовательские элементы, и описывать их структуру.
  • НовоеВнедрены новые возможности политик: сопоставление ключей объектов через путь ~ и авторизация условий AND в редакторе.
  • ИсправленоИсправлено скрытие незащищённых PEM-ключей, корректная передача вебхуков Nabu Casa и работа с метаданными статистики.
v8.6.030 сентября 2026 г.

Новые инструменты для политик, шаблонов и календарей, оптимизация описаний и исправления безопасности.

  • НовоеПолитики теперь могут утверждать вызовы из белого списка, а о pending-утверждениях сообщается через event bus.
  • НовоеДобавлен инструмент ha_eval_template для отладки шаблонов с ошибками, переменными и условиями.
  • НовоеУправление временем выполнения перенесено в отдельные инструменты, добавлена поддержка режима обновления календаря.
  • ИсправленоИсправлена блокировка IP при доступе к админским маршрутам с неадминскими токенами.
  • НовоеДобавлена локализация на азербайджанский язык и поддержка меток Home Assistant для зон.
v8.5.016 сентября 2026 г.

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

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

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

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

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

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

Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.