Home Assistant Model Context Protocol (MCP)
Сервер для взаимодействия ИИ-ассистентов с Home Assistant, позволяющий управлять устройствами умного дома.
Описание
Home Assistant MCP — это стандартизированный протокол для безопасного взаимодействия AI-моделей (Claude, GPT) с Home Assistant. Ключевые особенности: модульная архитектура на TypeScript с Bun для высокой производительности, транспорты stdio и HTTP/SSE для стриминга, встроенные инструменты для контроля света и климата, валидация параметров через Zod, extensible плагины. Применения: автоматизация умного дома, интеграция с AI-ассистентами, опционально speech-to-text с GPU-поддержкой. Идеально для разработчиков IoT и AI.
Возможности
Управление устройствами
Контроль света (яркость, цвет), климата (термостаты, HVAC) через встроенные инструменты.
Транспорты и стриминг
Поддержка stdio для CLI, HTTP/REST с SSE для реального времени и длинных операций.
Валидация и middleware
Проверка параметров с Zod, логирование, таймауты, обработка ошибок.
Интеграция с AI
Готовые утилиты для Claude и Cursor, генерация tool definitions для JSON-RPC.
Расширяемость
Плагин-система для добавления новых инструментов, модульная архитектура.
Speech-функции (опционально)
Wake word detection, speech-to-text с Whisper, поддержка GPU и Docker.
Установка
Установка через npx (просто): npx homeassistant-mcp (требует HASS_TOKEN в env).
Или клонирование: git clone https://github.com/jango-blockchained/homeassistant-mcp.git cd homeassistant-mcp bun install bun run build bun run dev
Для Docker: ./docker-build.sh [–speech] [–gpu], затем docker compose up -d.
Конфигурация: скопировать .env.example в .env, добавить HASS_URL и HASS_TOKEN.
Для Cursor: { “mcpServers”: { “homeassistant-mcp”: { “command”: “bash”, “args”: ["-c", “cd ${workspaceRoot} && bun run dist/index.js –stdio 2>/dev/null | grep -E ‘\{“jsonrpc”:“2\.0”’”], “env”: { “NODE_ENV”: “development”, “USE_STDIO_TRANSPORT”: “true”, “DEBUG_STDIO”: “true” } } } }