Сервер Model Context Protocol (MCP) для интеграции Home Assistant с Claude и другими LLM.

Обзор

Hass-MCP позволяет AI-ассистентам, таким как Claude, напрямую взаимодействовать с вашим экземпляром Home Assistant, позволяя им:

• Запрос состояния устройств и датчиков
• Управляющие лампы, выключатели и другие объекты
• Получите краткие обзоры вашего умного дома
• Устранение неполадок автоматизаций и сущностей
• Поиск конкретных сущностей
• Создавать направленные разговоры по общим задачам

Скриншоты

Особенности

• Управление сущностями: Получение состояний, управляющих устройств и поиск сущностей
• Резюме доменов: Получение общей информации о типах сущностей
• Поддержка автоматизации: автоматизации списка и управления
• Управляемые разговоры: Используйте подсказки для распространённых задач, таких как создание автоматизаций
• Умный поиск: Поиск сущностей по названию, типу или состоянию
• Редактирование Live Dashboard: Читайте и редактируйте дашборды Lovelace (карты и просмотры) через API WebSocket Home Assistant — изменения появляются мгновенно в открытых браузерах, с автоматическим резервным копированием и пробным просмотром
• Эффективность токенов: Бережливые JSON-ответы для минимизации использования токенов

Установка

Требования

Hass-MCP

A Model Context Protocol (MCP) server for Home Assistant integration with Claude and other LLMs.

Overview

Hass-MCP enables AI assistants like Claude to interact directly with your Home Assistant instance, allowing them to:

• Query the state of devices and sensors
• Control lights, switches, and other entities
• Get summaries of your smart home
• Troubleshoot automations and entities
• Search for specific entities
• Create guided conversations for common tasks

Screenshots

Features

• Entity Management: Get states, control devices, and search for entities
• Domain Summaries: Get high-level information about entity types
• Automation Support: List and control automations
• Guided Conversations: Use prompts for common tasks like creating automations
• Smart Search: Find entities by name, type, or state
• Live Dashboard Editing: Read and edit Lovelace dashboards (cards and views) over Home Assistant’s WebSocket API — changes appear instantly in open browsers, with automatic backups and a dry-run preview
• Token Efficiency: Lean JSON responses to minimize token usage

Installation

Prerequisites

• Home Assistant instance with Long-Lived Access Token
• One of the following:
  • Docker (recommended)
  • Python 3.13+ and uv

Setting Up With Claude Desktop

Docker Installation (Recommended)

1. Pull the Docker image:

   docker pull voska/hass-mcp:latest
   

2. Add the MCP server to Claude Desktop:

   a. Open Claude Desktop and go to Settings b. Navigate to Developer > Edit Config c. Add the following configuration to your claude_desktop_config.json file:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "HA_URL",
           "-e",
           "HA_TOKEN",
           "voska/hass-mcp"
         ],
         "env": {
           "HA_URL": "http://homeassistant.local:8123",
           "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
         }
       }
     }
   }
   

   d. Replace YOUR_LONG_LIVED_TOKEN with your actual Home Assistant long-lived access token