Model Context Protocol Server for Home Assistant
Интегрирует Home Assistant с LLM для естественного управления смарт-домом через MCP.
Описание
Это сервер на базе протокола MCP, который связывает локальный экземпляр Home Assistant с LLM-приложениями. Ключевые особенности: контроль устройств (свет, климат, замки), управление аддонами и пакетами HACS, создание автоматизаций, реал-тайм обновления via SSE и WebSocket. Технологии: Node.js (≥20.10), TypeScript, Docker Compose. Применения: AI-управление смарт-домом, мониторинг состояний, автоматизация через естественный язык для удобного контроля экосистемы.
Возможности
Контроль устройств
Управление светами, климатом, выключателями, замками, медиаплеерами и вакуумными роботами через API.
Управление автоматизацией
Создание, редактирование, дублирование и запуск автоматизаций с триггерами, условиями и действиями.
Управление аддонами
Установка, удаление, запуск/остановка аддонов Home Assistant с доступом к конфигурации.
Управление пакетами HACS
Установка и обновление интеграций, тем, скриптов из Home Assistant Community Store.
Реал-тайм мониторинг
Обновления состояний устройств, событий и автоматизаций через SSE и WebSocket.
Безопасность и API
Токенная аутентификация, rate limiting, обработка ошибок и поддержка батч-действий.
Установка
Рекомендуемый Docker-установка:
- Клонируйте репозиторий: git clone https://github.com/jango-blockchained/homeassistant-mcp.git && cd homeassistant-mcp
- Скопируйте и настройте .env: cp .env.example .env (укажите HASS_HOST, HASS_TOKEN, HASS_SOCKET_URL).
- Запустите: docker compose up -d
- Проверьте: http://localhost:3000/health Предварительно: Node.js ≥20.10, NPM, Docker Compose, работающий Home Assistant с токеном и HACS.