Home Assistant와 Claude 및 기타 LLM과의 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

Hass-MCP는 Claude와 같은 AI 비서가 Home Assistant 인스턴스와 직접 상호작용할 수 있게 하여 다음과 같은 기능을 제공합니다:

• 장치 및 센서의 상태 조회
• 제어등, 스위치 및 기타 장치
• 스마트 홈 요약 자료 받기
• 자동화 및 엔터티 문제 해결
• 특정 개체 탐색
• 일반적인 작업에 대한 안내 대화 생성

스크린샷

특징

• 엔터티 관리: 상태 획득, 장치 제어 및 엔티티 검색
• 도메인 요약: 엔터티 유형에 대한 고수준 정보 제공
• 자동화 지원: 자동화 목록 및 제어
• 가이드 대화: 자동화 생성과 같은 일반적인 작업에 프롬프트를 사용하세요
• 스마트 검색: 이름, 유형, 또는 상태로 엔티티 찾기
• 라이브 대시보드 편집: Home Assistant의 WebSocket API를 통해 Lovelace 대시보드(카드 및 뷰)를 읽고 편집할 수 있습니다 — 변경 사항이 즉시 열린 브라우저에 나타나며, 자동 백업과 사전 실행 미리보기가 제공됩니다
• 토큰 효율성: 토큰 사용을 최소화하기 위한 린 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