Описание

Это сервер, реализующий Model Context Protocol (MCP) для Home Assistant. Он позволяет моделям ИИ, таким как Claude, взаимодействовать с умным домом через WebSocket API HA. Требует установки custom component в HA и long-lived access token. Идеален для автоматизации: управление устройствами, мониторинг состояний и интеграция ИИ в сценарии умного дома. Разработан на Python, использует uv для запуска.

Возможности

✓

Интеграция с Home Assistant

Подключение через WebSocket API для доступа к состоянию и управлению устройствами.

✓

Поддержка MCP

Реализация протокола для взаимодействия моделей ИИ (например, Claude) с HA.

✓

Аутентификация

Использование long-lived токенов для безопасного доступа к API.

✓

Логирование

Генерация логов для отладки и мониторинга работы сервера.

Установка

Установите custom component home-assistant-model-context-protocol в Home Assistant.
Создайте Long Lived Access Token в профиле HA.
Клонируйте репозиторий в директорию, например /Users/allen/Development/mcp-server-home-assistant.
Отредактируйте claude_desktop_config.json:

{
    "mcpServers": {
        "Home-assistant": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/allen/Development/mcp-server-home-assistant",
                "run",
                "mcp-server-home-assistant",
                "-v",
                "-v"
            ],
            "env": {
                "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",
                "HOME_ASSISTANT_API_TOKEN": "your_token_here"
            }
        }
    }
}

Просматривайте логи в ~/Library/Logs/Claude/mcp-server-Home-assistant.log.

mcp-server-home-assistant