Ha MCP

Ha MCP

homeassistant-aiMIT
3.2k звёзд126 форков
ha-mcp — это сервер Model Context Protocol (MCP) для Home Assistant. Он даёт AI-ассистентам прямой доступ к вашему умному дому. Вместо долгих поисков в интерфейсе вы просто пишете запрос: «Выключи всё на кухне» или «Поставь будильник на 7 утра». Ассистент через ha-mcp отправляет команду напрямую в Home Assistant. Сервер создан разработчиками для разработчиков. Он открывает доступ к 80+ инструментам: от базового управления устройствами до сложных манипуляций с автоматизациями и YAML-конфигурацией. ha-mcp подходит как для бытовых сценариев, так и для профессиональных интеграций.
AI и машинное обучение
Подключить MCPОткрыть на GitHub
Подключение

Подключить Ha MCP

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Ha MCP

Ha MCP относится к AI и машинное обучение. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикhomeassistant-ai
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Управление устройствами: включайте и выключайте свет, регулируйте яркость, управляйте термостатами, замками и другими умными приборами.
  • Выполнение сервисов: вызывайте любой сервис Home Assistant по имени домена и службы, например, light.turn_on или climate.set_temperature.
  • Управление сценарими и скриптами: запускайте подготовленные сцены («Доброе утро», «Сон») и скрипты из вашей конфигурации.
  • Работа с автоматизациями: включайте, отключайте и проверяйте статус ваших автоматизаций в реальном времени.
  • Массовые операции: управляйте группами устройств по зонам, областям или меткам (labels).
  • Запрос конфигурации: читайте настройки Home Assistant, получайте списки платформ, интеграций и кастомных объектов.
  • История и статистика: получайте данные о температуре, энергопотреблении и других параметрах за любой период.
  • Изменение YAML-конфига (бета): вносите правки в файлы конфигурации прямо из диалога (требуется осторожность).

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

  1. Установите сервер. Проще всего через uv:

    uvx ha-mcp

    Если у вас нет uv, воспользуйтесь pip: pip install ha-mcp.

  2. Получите токен доступа. Зайдите в Home Assistant, откройте профиль и создайте «Long-Lived Access Token».

  3. Настройте клиент. Для Claude Desktop отредактируйте файл claude_desktop_config.json:

    { "mcpServers": { "ha-mcp": { "command": "uvx", "args": ["ha-mcp"], "env": { "HA_URL": "http://your-homeassistant.local:8123", "HA_ACCESS_TOKEN": "ваш_токен" } } } }

    Замените HA_URL на адрес вашего Home Assistant, HA_ACCESS_TOKEN — на токен.

  4. Перезапустите Claude Desktop. Готово, можно отдавать команды.

Примеры запросов

Вот что вы можете попросить AI-ассистента сделать через ha-mcp:

  • «Покажи состояние всех датчиков температуры на первом этаже.»
  • «Включи свет в гостиной, установи яркость 50% и запусти сцену "Вечер".»
  • «Проверь, какие автоматизации сработали за последние 2 часа.»
  • «Найди все выключенные светильники. Включи их, когда никого нет дома?»

Технические детали

  • Язык: Python
  • Транспорт: stdio
  • Лицензия: MIT
  • Инструменты: 80+
  • Совместимость: Claude Desktop, Cline, Continue.dev, любые MCP-клиенты
  • Установка: uvx ha-mcp, pip install ha-mcp

Поделиться