Home Assistant MCP 서버

개요

ha-mcp (비공식 및 멋진 Home Assistant MCP 서버)는 여러분의 Home Assistant 인스턴스를 AI 어시스턴트를 위한 강력한 도구로 변환하는 최고의 커뮤니티 제작 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 Claude, Cursor, Gemini CLI 및 모든 MCP 호환 클라이언트와 같은 LLM이 자연어를 사용하여 스마트 홈과 직접 상호작용할 수 있게 해줍니다.

Home Assistant에 이제 공식 mcp_server 통합 기능이 포함되었지만, ha-mcp는 훨씬 더 풍부한 기능(80개 이상의 도구), 쉬운 HA OS 애드온, 전용 설정 마법사를 제공하여 대부분의 사용자에게 최적의 선택지가 됩니다.

주요 기능

• 자연어 제어: 조명 켜기/끄기, 기후 조절, 커버 열기, 미디어 재생 및 모든 서비스 실행.
• 실시간 상태 및 엔터티 쿼리: 센서 값, 장치 상태 또는 전체 홈 요약 정보 요청.
• 자동화 관리: 동적으로 자동화 생성, 편집, 활성화/비활성화, 트리거 또는 일시 중지.
• 고급 기능: YAML 편집, HACS 관리, Lovelace 대시보드 생성, 업데이트 처리, 백업 및 80개 이상의 특수 도구.
• 다중 클라이언트 지원: Claude Desktop, Cursor, VS Code + Cline, Gemini CLI 등과 원활하게 작동.
• 쉬운 설치: 공식 HA OS 애드온, Docker 또는 빠른 실행 옵션. -[*] 안전하고 신뢰할 수 있음: 적절한 인증을 통한 장기 액세스 토큰 사용.

사용 사례

• 핸즈프리 스마트 홈: "아래층 모든 조명을 끄고 현관 문을 잠그세요."
• AI 기반 자동화: "석양에 현관 조명을 켜고 저에게 알림을 보내는 자동화를 만드세요."
• 대시보드 및 구성 편집: Cursor나 Claude가 Lovelace 대시보드 또는 YAML 구성을 생성하고 배포하도록 하세요.
• 모니터링 및 문제 해결: "침실의 현재 온도는 얼마입니까? 왜 모션 센서가 오프라인 상태인가요?"
• 복잡한 워크플로: 다른 MCP 서버와 결합하여 완전한 AI 조정 홈 + 개발 파이프라인 구성.

설치 (가장 쉬운 방법)

Home Assistant OS 애드온

1. HA 애드온 스토어에 https://github.com/homeassistant-ai/ha-mcp 저장소를 추가합니다.
2. Home Assistant MCP Server 애드온을 설치하고 시작합니다.
3. 장기 액세스 토큰을 생성하고 구성합니다.
4. 공식 설정 마법사를 사용하세요: https://homeassistant-ai.github.io/ha-mcp/setup/

대안 옵션: Docker, uvx 또는 저장소에서 수동 설치.

호환성

• 클라이언트: Claude Desktop, Cursor, Gemini CLI, Codex, 모든 MCP 호환 앱.
• Home Assistant: 현재 HA 버전(OS, Container, Core)에서 작동.
• 라이선스: 오픈소스 (정확한 약관은 저장소 확인).

커뮤니티와 대체 솔루션

이 버전(v7.1.0+, 기준 2026년 3월)은 가장 활발하게 유지보수되고 기능이 풍부합니다. 다른 커뮤니티 포크도 존재하지만, 포럼, 유튜브, Reddit에서 가장 권장되는 것은 homeassistant-ai 조직의 ha-mcp입니다.

더 간단한 사용 사례를 위해서는 공식 Home Assistant mcp_server 통합 기능도 이용할 수 있습니다.

지금 바로 AI를 통해 스마트 홈을 제어해보세요 — ha-mcp는 이를 간단하면서도 강력하고 재미있게 만들어 줍니다.