mcp-ha: MCP-сервер для Home Assistant в виде аддона

Этот аддон Home Assistant предоставляет сервер MCP (Model Context Protocol). На практике: вы подключаете Claude, Gemini или любой другой MCP-клиент к своему экземпляру и общаетесь со своим домом.

«Какие лампы остались включёнными?», «Почему автоматизация отопления не сработала прошлой ночью?», «Построй график моего энергопотребления за неделю».

Документация: devitek.github.io/mcp-ha (на английском и французском)

Что он охватывает

Всего 16 инструментов, разработанных для экономии контекстного окна LLM: компактные, постраничные и ограниченные ответы, с примечаниями, направляющими ассистента к более точным запросам.

Related MCP server: hass-mcp

Почему не официальная интеграция HA MCP?

Она существует и работает, но идёт через Assist API: только сущности, доступные для Assist, без истории, без реестров, без аддонов, без конфигураций автоматизаций. Этот аддон даёт прямой, детальный доступ. Оба могут сосуществовать.

Установка

Требования: Home Assistant OS или Supervised (аддону нужен Supervisor).

1. Добавьте этот репозиторий в репозитории аддонов:

   

   Или вручную: Настройки, Аддоны, Магазин аддонов, меню из трёх точек, Репозитории, затем вставьте https://github.com/Devitek/mcp-ha.

2. Установите «MCP Home Assistant» и запустите его.

3. Откройте вкладку «Конфигурация» аддона: при первом запуске там был создан и сохранён токен API (он также выводится в журнале аддона).

Подключение клиента

Claude Code:

claude mcp add --transport http home-assistant \
  http://HA_IP:9583/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop и Gemini CLI: см. руководство по клиентам на сайте документации.

Безопасность, кратко

• По умолчанию только чтение. Инструмент вызова сервисов даже не существует для клиента, если вы не включите allow_write.

• Многоуровневая защита при включённой записи: денлист опасных сервисов (HA shutdown, shell_command...), глобальные списки разрешений/запретов для сущностей, режим dry_run, JSON-журнал аудита каждой попытки в журнале.

• Только локальная сеть. Нет TLS, нет OAuth: не открывайте порт 9583 в интернет.

Полная модель угроз описана в SECURITY.md.

Документация

• Сайт документации: установка, конфигурация, клиенты, справочник инструментов, архитектура (английский и французский)

• Документация аддона: страница, отображаемая в интерфейсе HA

• Руководство по внесению вклада: настройка разработки, соглашения, релизы

• Проблемы репозитория: база знаний проекта, каждое проектное решение и подводный камень отслеживаются там с метками décision и écueil (на французском)

Лицензия

MIT