홈 어시스턴트 MCP

AI 어시스턴트를 사용하여 Home Assistant 기기를 제어하기 위한 MCP(모델 컨텍스트 프로토콜) 통합.

개요

이 MCP를 통해 AI 어시스턴트가 Home Assistant 기기를 제어할 수 있습니다. 다음과 같은 도구를 제공합니다.

1. Home Assistant 인스턴스에서 엔터티 검색
2. 장치 제어(켜기/끄기)
3. 조명 색상 및 밝기 제어

필수 조건

• Python 3.11 이상
• API를 통해 실행 중이고 접근 가능한 Home Assistant 인스턴스
• 홈 어시스턴트 장기 액세스 토큰

설치

1. 이 저장소를 복제하세요
2. Python 환경 설정:

지엑스피1

구성

Home Assistant 장기 액세스 토큰 받기

1. Home Assistant 인스턴스로 이동하세요
2. 프로필로 이동합니다(사이드바에서 사용자 이름을 클릭합니다)
3. "장기 액세스 토큰"까지 아래로 스크롤하세요.
4. "MCP 통합"과 같은 설명적 이름으로 새 토큰을 만듭니다.
5. 토큰을 복사하세요(한 번만 볼 수 있습니다)

Cursor AI에 설정

Cursor의 MCP 구성에 다음 구성을 추가하세요.

바꾸다:

• /path/to/your/home-assistant 이 디렉토리의 실제 경로로 지정합니다.
• Home Assistant 장기 액세스 토큰과 함께 your_home_assistant_token_here 사용하세요.

홈 어시스턴트 URL 구성

기본적으로 MCP는 http://homeassistant.local:8123 에서 Home Assistant에 연결을 시도합니다.

Home Assistant가 다른 URL에 있는 경우 app/config.py 에서 HA_URL 변수를 수정할 수 있습니다.

용법

구성이 완료되면 Cursor AI를 사용하여 Home Assistant 기기를 제어할 수 있습니다.

• 기기 검색: "내 거실 조명 찾기"
• 제어 장치: "주방 불 켜줘"
• 조명 색상 제어: "거실 조명을 빨간색으로 설정"
• 밝기 조정: "식당 조명을 50% 밝기로 파란색으로 설정해 주세요"

조명 제어 기능

MCP는 이제 고급 조명 제어 기능을 지원합니다.

1. 색상 제어 : 호환되는 조명에 대한 RGB 색상을 설정합니다.
   • RGB 값(각 구성 요소에 대해 0~255)을 사용하여 색상을 지정합니다.
   • 예: 빨간색의 경우 set_device_color("light.living_room", 255, 0, 0)
2. 밝기 조절 : 조명 밝기를 조절합니다
   • 선택적 밝기 매개변수(0-255)
   • 색상 변경과 결합 가능
   • 예: 중간 밝기의 파란색을 원할 경우 set_device_color("light.dining_room", 0, 0, 255, brightness=128)

문제 해결

• 인증 오류가 발생하면 토큰이 올바르고 만료되지 않았는지 확인하세요.
• 구성된 URL에서 Home Assistant 인스턴스에 접속 가능한지 확인하세요.
• 색상 제어 문제의 경우:
  • 조명 엔티티가 RGB 색상 제어를 지원하는지 확인하세요.
  • 색상 변경을 시도하기 전에 조명이 켜져 있는지 확인하세요.

미래 역량

동적 엔터티 노출

현재 구현에는 장치를 제어하기 위한 2단계 프로세스가 필요합니다.

1. 자연어를 사용하여 엔터티 검색
2. 특정 entity_id를 사용하여 엔터티를 제어합니다.

계획된 개선 사항은 엔터티를 제어 장치 도구에 노출하는 보다 동적인 방식을 만들어 AI가 다음을 수행할 수 있도록 하는 것입니다.

• 보다 자연스러운 명령(예: "주방 조명 끄기")을 통해 장치를 직접 제어합니다.
• 더 빠른 액세스를 위해 자주 사용되는 엔터티를 캐시합니다.
• 밝기, 온도 또는 기타 속성 조정과 같은 보다 복잡한 작업 지원
• 엔티티 그룹과 장면을 보다 직관적으로 처리합니다.

이를 통해 AI 어시스턴트를 통해 Home Assistant 기기를 제어할 때 작업 시간이 크게 단축되고 더욱 원활한 사용자 경험이 제공될 것입니다.