@genm/switchbot-mcp

AI 어시스턴트에 SwitchBot 장치 제어 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다.

일본어

특징

• 장치 목록
• 장치 상태 가져오기
• 제어 장치(켜기/끄기)
• 기기 설정 변경
• 장면 제어
• 장치 상태 모니터링

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 SwitchBot MCP 서버를 자동으로 설치하는 방법:

지엑스피1

수동 설치

설정

1. SwitchBot API 구성

1. SwitchBot 앱을 설치하세요
2. 계정을 생성하고 로그인하세요
3. 프로필 > 설정 > 개발자 옵션으로 이동하세요.
4. 토큰과 비밀 키를 모두 얻으세요

2. MCP 서버 구성

claude_desktop_config.json 에 다음을 추가합니다.

3. 환경 변수

지원되는 장치

• 플러그
  • 거실 플로어 램프
  • 사무실 PC 전원 공급 장치
• 봇
  • 주방 커피 메이커
  • 거실 공기청정기
• 커튼
  • 침실 창 커튼
  • 스터디룸 블랙아웃 커튼
• 에어컨
  • 거실 에어컨
  • 침실 에어컨
• 가습기
  • 침실 가습기
  • 스터디룸 가습기
• 빛
  • 주방 천장 조명
  • 침실 야간 조명
• 원격 제어
  • 거실 TV
  • 스터디룸 선풍기

장치 이름 예

AI 도우미가 기기를 더 쉽게 제어할 수 있도록 기기에 설명적인 이름을 지정하는 것이 좋습니다. 예:

• "커튼" 대신 "침실 커튼"
• "에어컨" 대신 "거실용 에어컨"
• "봇" 대신 "주방 커피 메이커"

이러한 명명 규칙은 AI 비서가 각 장치의 맥락과 위치를 이해하는 데 도움이 됩니다.

지원되는 작업

장치 관리

• 장치 목록
• 장치 상태 가져오기
• 장치 켜기/끄기
• 기기 설정 변경

장면 관리

• 장면 목록
• 장면 실행

센서 정보

• 온도
• 습기
• 명도
• 운동

개발

문제 해결

장치가 응답하지 않음

1. 장치가 Bluetooth 범위 내에 있는지 확인하세요
2. 기기 배터리 상태 확인
3. SwitchBot 허브 연결 상태 확인

인증 오류

1. 토큰 및 비밀 키 만료 확인
2. 토큰과 비밀 키를 다시 생성합니다
3. 환경 변수 업데이트

특허

아이에스씨