homeassistant-ai/ha-mcp
Claude·ChatGPT로 홈어시스턴트를 AI로 관리하는 ha-mcp
원제 homeassistant-ai/ha-mcp
스타 7,719당일 +714Python
Key Point
AI 어시스턴트로 홈 자동화 설정·편집·디버깅을 자연어로 처리할 수 있어 비개발자도 복잡한 Home Assistant 구성이 가능해진다.
핵심 요약
- HA-MCP는 Claude, ChatGPT 등 AI 어시스턴트로 Home Assistant를 설정하고 자동화할 수 있는 MCP 서버 프로젝트로, Python으로 작성되었다.
- 설치는 Home Assistant 2026.8.0 이상에서 HACS 또는 마켓플레이스를 통해 HA-MCP 통합을 설치하고 관리자 토큰을 설정한 후 AI 클라이언트에 연결 URL을 입력하는 방식이다.
- v7.3.0부터 `ha_config_set_yaml`이 베타 기능으로 이동했으며, 인프로세스 서버(Home Assistant 내에서 실행), 애드온, Docker, PyPI/uvx, 표준 입출력 등 여러 설치 방식을 지원한다.
- 자연어로 "일몰에 현관 불 켜는 자동화 만들어", "대시보드에 날씨 카드 추가해" 같은 명령을 내리면 자동화, 스크립트, 대시보드 편집, 스마트홈 디버깅을 수행한다.
- 검색, 제어, 자동화/스크립트/헬퍼 관리, 모니터링, 백업/복원, 보안 정책 등 87개의 도구를 제공하며, 읽기 전용 모드 전환과 도구별 활성화/비활성화 제어가 가능하다.
- 파일 시스템 접근과 YAML 설정 편집 같은 고급 기능은 별도의 HA-MCP 파일·YAML 도구 엔트리를 설치하고 베타 기능을 활성화해야 하며, 편집 시 자동 백업된다.
- Home Assistant 내장 MCP 서버와 달리 ha-mcp는 디바이스 제어뿐 아니라 자동화/대시보드 구축·편집, 로그·추적 데이터 분석, 헬퍼·영역·레이블 관리 등 전체 Home Assistant 구성이 가능하다.
- macOS, Linux, Windows용 데모 서버를 제공해 실제 Home Assistant 연결 전 동작을 미리 확인할 수 있으며, 15개 이상 클라이언트를 위한 설정 마법사를 제공한다.
- Z-Wave 설정값은 `ha_manage_radio` 도구로 해당 설정 엔터티가 비활성화되어 있어도 읽을 수 있으며, 캐시 기본값과 명시적 디바이스 읽기 옵션을 제공한다.
- 헬퍼 편집 복원 시 기존 헬퍼는 새로운 안전 백업이 필요하며, 엔터티 ID 충돌·검증 실패 시 새 헬퍼를 생성하고 안내한다.
저장소 보기 ↗github.com