SwitchBot MCP 서버

@genm/switchbot-mcp

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

일본어

특징

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

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

npm install @genm/switchbot-mcp

설정

1. SwitchBot API 구성

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

2. MCP 서버 구성

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

{
  "mcpServers": {
    "switchbot": {
      "command": "node",
      "args": ["path/to/switchbot-mcp/build/index.js"],
      "env": {
        "SWITCHBOT_TOKEN": "your_token",
        "SWITCHBOT_SECRET": "your_secret"
      }
    }
  }
}

3. 환경 변수

SWITCHBOT_TOKEN=your_token
SWITCHBOT_SECRET=your_secret

지원되는 장치

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

장치 이름 예

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

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

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

지원되는 작업

장치 관리

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

장면 관리

장면 목록
장면 실행

센서 정보

온도
습기
명도
운동

개발

# Build
npm run build

# Development mode (TypeScript)
npm run dev

# Start
npm start

문제 해결

장치가 응답하지 않음

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

인증 오류

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

특허

아이에스씨

Install Server

HTTP connection URL

You must to connect to the server.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

SwitchBot API를 통해 장치 관리, 장면 실행, 센서 정보 모니터링과 같은 기능을 제공하여 AI 어시스턴트가 SwitchBot 장치를 제어할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

CodeSavant
twolven
-
security
A
license
-
quality
Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
Last updated -
8
Python
MIT License
Browser Automation MCP Server
grapheneaffiliate
-
security
F
license
-
quality
Enables AI agents to control web browsers via a standardized interface for operations like launching, interacting with, and closing browsers.
Last updated -
0
JavaScript
ClickUp MCP Server
taazkareem
A
security
A
license
A
quality
Enables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.
Last updated -
18
605
201
TypeScript
MIT License
Home Assistant MCP
guilhermelirio
-
security
A
license
-
quality
Provides tools for AI assistants to interact with smart home devices through Home Assistant, allowing operations like checking entity states and calling services.
Last updated -
TypeScript
MIT License

View all related MCP servers

SwitchBot MCP Server