-
security-
license-
qualityEnables AI agents to control Minecraft bots through a standardized JSON-RPC interface.
Last updated -
4
34
MIT License
@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 허브 연결 상태 확인
인증 오류
토큰 및 비밀 키 만료 확인
토큰과 비밀 키를 다시 생성합니다
환경 변수 업데이트
특허
아이에스씨
Related MCP Servers
- Asecurity-licenseAqualityProvides tools for AI assistants to interact with smart home devices through Home Assistant, allowing operations like checking entity states and calling services.Last updated -33MIT License
- Asecurity-licenseAqualityEnables AI assistants to interact with WordPress sites through REST APIs, allowing programmatic management of posts, users, comments, categories, and tags with secure authentication.Last updated -2946MIT License
- -security-license-qualityEnables AI assistants to control a browser through a set of tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.Last updated -