hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Provides tools for controlling various Home Assistant domains including lights (on/off, brightness), climate systems (temperature, HVAC modes), locks (lock/unlock), alarm control panels (arm/disarm), and humidifiers (humidity control).
🤝 홈 어시스턴트 MCP 서버
Home Assistant와 통합되어 스마트 홈 제어 기능을 제공하는 MCP(Model Context Protocol) 서버 프로젝트입니다.
프롬프트
서버는 각 도메인의 도구 세트에 대한 프롬프트를 제공합니다.
도구
이 서버는 다양한 Home Assistant 도메인에 대한 제어를 구현합니다. 현재 다음 항목을 지원합니다.
- 💡 조명: 켜기/끄기, 밝기 조절
- 🌡️ 기후: 온도 조절, HVAC 모드
- 🔒 잠금: 잠금/잠금 해제 기능
- 🚨 알람 제어판: 보안 시스템 활성화/비활성화
- 💧 가습기: 습도 조절
예시 도구는 다음과 같습니다.
지엑스피1
구성
환경 변수
다음을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.
빠른 시작
설치하다
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 라이센스 - 자세한 내용은 라이센스를 참조하세요.
This server cannot be installed
자연어를 통해 스마트 홈 제어 기능을 제공하기 위해 Home Assistant와 통합된 모델 컨텍스트 프로토콜 서버로, 조명, 기후 시스템, 잠금 장치, 알람, 가습기 등의 장치를 지원합니다.