voska/hass-mcp

해결하는 문제

이 도구는 AI 어시스턴트(예: Claude)가 Home Assistant 인스턴스에 직접 접근할 수 있도록 해줍니다. 사용자는 수동 설정 대신 자연어를 사용하여 스마트홈을 제어하고, 장치 상태를 조회하며, 자동화 문제를 진단하고, 대시보드를 관리할 수 있습니다.

작동 방식

Model Context Protocol (MCP) 서버를 구현하여 LLM과 Home Assistant API 사이의 다리 역할을 합니다. LLM이 호출할 수 있는 도구 세트를 제공하여 조명 전원 끄기와 같은 작업 수행, 센서 이력이나 오류 로그와 같은 데이터 조회, WebSocket을 통한 Lovelace 대시보드 읽기 및 실시간 편집(자동 백업 및 드라이런 미리보기 지원)이 가능하며, stdio 및 스트리밍 가능한 HTTP 전송 방식을 모두 지원합니다.

대상 사용자

스마트홈 애호가이자 Home Assistant 사용자로서, 고급 AI 에이전트와 통합하여 더 쉬운 제어와 안내된 문제 해결을 원하는 사용자에게 적합합니다.

주요 기능

• 완전한 장치 제어: 상태 조회, 엔티티 제어, Home Assistant의 모든 서비스 호출 가능.
• 대시보드 편집: Lovelace 대시보드를 읽고 실시간으로 편집하며, 자동 백업과 드라이런 미리보기 기능 제공.
• 고급 진단 기능: Home Assistant 오류 로그 및 엔티티 상태 이력/통계에 접근 가능.
• 안내형 대화: 자동화 생성, 문제 디버깅, 루틴 최적화를 위한 내장 프롬프트 제공.
• 토큰 효율성: LLM의 토큰 소비를 최소화하기 위해 가벼운 JSON 응답 사용.
• 유연한 배포: Docker, uv/uvx, HTTP 전송 방식을 지원하여 네트워크 기반 도구 구축 가능.