@genm/switchbot-mcp

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

일본어

특징

• 장치 목록

• 장치 상태 가져오기

• 제어 장치(켜기/끄기)

• 기기 설정 변경

• 장면 제어

• 장치 상태 모니터링

Related MCP server: Home Assistant MCP

설치

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. 환경 변수 업데이트

특허

아이에스씨