Home Assistant MCP

홈 어시스턴트 MCP

이는 Home Assistant와 통합하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버로, AI 어시스턴트가 스마트 홈 기기와 상호 작용할 수 있도록 해줍니다.

설정

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Home Assistant 통합을 자동으로 설치하려면:

지엑스피1

수동 설치

1. 종속성 설치:

2. 환경 변수 구성:
   • Home Assistant에서 장기 액세스 토큰을 받으세요
   • 프로젝트 루트의 .env 파일에서 환경 변수를 구성합니다.

서버 시작

개발을 위해:

사용 가능한 도구

홈 어시스턴트 API 검증

• homeassistant_api : Home Assistant API가 온라인 상태인지 확인합니다.
  • 매개변수: 없음
  • 예: homeassistant_api()

엔티티 상태 가져오기

• homeassistant_get_state : Home Assistant 엔티티의 현재 상태를 가져옵니다.
  • 매개변수: entity_id (엔터티 ID)
  • 예: homeassistant_get_state("light.living_room")

콜 서비스

• homeassistant_call_service : Home Assistant 엔티티에 대한 서비스를 호출합니다.
  • 매개변수:
    • entity_id (엔터티 ID)
    • domain (서비스 도메인)
    • service (전화할 서비스)
  • 예: homeassistant_call_service("light.living_room", "light", "turn_on")

개발

이 프로젝트에서는 TypeScript와 MCP SDK 라이브러리를 사용하여 Claude, GPT 등의 언어 모델에서 액세스할 수 있는 도구를 만듭니다.

새로운 도구를 추가하려면:

1. src/tools/[category] 에 모듈을 생성합니다.
2. 기존 패턴에 따라 도구를 구현하세요
3. src/index.ts 에 모듈을 등록합니다.

기여

기여를 환영합니다! 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.