homeassistant-ai/ha-mcp

해결하는 문제

AI 어시스턴트(Claude 또는 ChatGPT 등)가 Home Assistant 스마트 홈 설정과 직접 상호작용할 수 있게 합니다. 사용자는 기기와 자동화를 수동으로 구성할 필요 없이 자연어를 사용하여 집을 제어하고, 기기 상태를 조회하며, 기본 시스템 구성을 관리할 수 있습니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP) 서버를 구현합니다. 이 서버는 AI 클라이언트와 Home Assistant API 사이의 가교 역할을 합니다. AI가 서비스 실행, 엔티티 상태 읽기, YAML 구성 편집, 대시보드 관리와 같은 작업을 수행하기 위해 호출할 수 있는 포괄적인 도구 세트(총 87개)를 제공합니다.

대상 사용자

AI 어시스턴트를 스마트 홈 생태계에 통합하여 더 쉽게 제어하고 구성하려는 스마트 홈 애호가 및 Home Assistant 사용자.

주요 특징

• 광범위한 도구 세트: 검색, 기기 제어, 자동화 관리 및 시스템 관리를 아우르는 87개의 도구 제공.
• 다양한 배포 옵션: Home Assistant 커스텀 구성 요소 (HACS를 통해), Home Assistant 앱/애드온, Docker 컨테이너 또는 독립형 Python 패키지로 설치 가능.
• 자연어 구성: AI가 일반 텍스트 명령을 사용하여 자동화, 스크립트 및 대시보드 카드를 생성할 수 있음.
• 안전 기능: '읽기 전용 모드' 토글, 도구별 활성화/비활성화 설정, 편집 시 자동 백업 포함.
• 원격 액세스: Nabu Casa, webhooks, OIDC 인증을 포함한 다양한 원격 연결 방법 지원.