🤝 홈 어시스턴트 MCP 서버
Home Assistant와 통합되어 스마트 홈 제어 기능을 제공하는 MCP(Model Context Protocol) 서버 프로젝트입니다.
프롬프트
서버는 각 도메인의 도구 세트에 대한 프롬프트를 제공합니다.
도구
이 서버는 다양한 Home Assistant 도메인에 대한 제어를 구현합니다. 현재 다음 항목을 지원합니다.
💡 조명: 켜기/끄기, 밝기 조절
🌡️ 기후: 온도 조절, HVAC 모드
🔒 잠금: 잠금/잠금 해제 기능
🚨 알람 제어판: 보안 시스템 활성화/비활성화
💧 가습기: 습도 조절
예시 도구는 다음과 같습니다.
지엑스피1
구성
환경 변수
다음을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.
Related MCP server: MCP Personal Assistant Agent
빠른 시작
설치하다
Home Assistant를 설치하고 장기 액세스 토큰을 받는 방법에 대한 지침을 따르세요.
클로드 데스크탑
MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json
개발
건축 및 출판
배포를 위해 패키지를 준비하려면:
종속성 동기화 및 잠금 파일 업데이트:
패키지 배포 빌드:
이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.
PyPI에 게시:
참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.
토큰:
--token또는UV_PUBLISH_TOKEN또는 사용자 이름/비밀번호:
--username/UV_PUBLISH_USERNAME및--password/UV_PUBLISH_PASSWORD
디버깅
MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.
다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.
Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.
기여하다
이 프로젝트에 기여하는 데 관심을 가져주셔서 감사합니다!
자세한 내용은 CONTRIBUTING.md를 참조하세요.
특허
MIT 라이센스 - 자세한 내용은 라이센스를 참조하세요.