Перейти к содержимому

Home Assistant MCP Server

Сервер для взаимодействия с Home Assistant, позволяющий контролировать и мониторить устройства.

JavaScript
44 stars

Описание

Это сервер на базе Model Context Protocol (MCP) для интеграции с Home Assistant. Он предоставляет инструменты для получения состояний устройств, их управления (вкл/выкл), запуска автоматизаций и листинга доступных сущностей. Разработан на Node.js с использованием TypeScript для API. Идеален для смарт-хоум интеграций в AI-приложениях, автоматизации задач и мониторинга IoT-устройств через совместимые платформы.

Возможности

Получение состояний устройств

Получает текущее состояние указанного entity (например, света в комнате).

Управление состоянием устройств

Включает или выключает устройства, такие как выключатели или лампы.

Запуск автоматизаций

Триггерит автоматизации по ID, например, утреннюю рутину.

Листинг сущностей

Перечисляет доступные устройства, с опциональной фильтрацией по домену (например, light).

Установка

  1. Клонируйте репозиторий:
git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp
  1. Установите зависимости:
npm install
  1. Соберите проект:
npm run build
  1. Настройте сервер MCP, добавив в файл настроек (обычно ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json для VSCode):
{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

Замените your-homeassistant-url и your-long-lived-access-token на URL вашей инстанции Home Assistant и токен доступа.

Информация

Язык
JavaScript
Лицензия
MIT License
GitHub Stars
44

Ссылки