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-ml
Открыть на GitHub

Установка

uvx ha-mcp

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

Общее

  • СтатусСообщество
  • Разработчик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

Поделиться