S
SwitchBot控制器 SwitchBot控制工具
@genm/switchbot-mcp
1 Stars
39 次浏览
genm
更新于 2026-08-23
启用AI助手控制SwitchBot设备，通过SwitchBot API提供设备管理、场景执行和传感器信息监控等功能。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"switchbot": {
"args": [
"path/to/switchbot-mcp/build/index.js"
],
"command": "node",
"env": {
"SWITCHBOT_SECRET": "your_secret",
"SWITCHBOT_TOKEN": "your_token"
}
}
}
}该服务需要配置环境变量：SWITCHBOT_SECRET、SWITCHBOT_TOKEN
可用工具 （3 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
list_devices
デバイス一覧を取得します
该工具无需必填参数，直接调用即可
get_device_status 1 个参数 需填 1 项
デバイスのステータスを取得します
必填参数：deviceId
control_device 2 个参数 需填 2 项
デバイスを制御します
必填参数：deviceId、command
服务介绍
@genm/switchbot-mcp
一个提供SwitchBot设备控制能力给AI助手的Model Context Protocol服务器。
功能
- 列出设备
- 获取设备状态
- 控制设备（开关）
- 更改设备设置
- 场景控制
- 设备状态监控
安装
通过Smithery安装
要通过Smithery自动为Claude Desktop安装SwitchBot MCP服务器：
npx -y @smithery/cli install @genm/switchbot-mcp --client claude
手动安装
npm install @genm/switchbot-mcp
设置
1. SwitchBot API配置
- 安装SwitchBot应用程序
- 创建账户并登录
- 转到个人资料 > 设置 > 开发者选项
- 获取token和密钥
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电源
- 机器人
- 厨房咖啡机
- 客厅空气净化器
- 窗帘
- 卧室窗帘
- 书房遮光帘
- 空调
- 客厅空调
- 卧室空调
- 加湿器
- 卧室加湿器
- 书房加湿器
- 灯
- 厨房顶灯
- 卧室夜灯
- 遥控器
- 客厅电视
- 书房风扇
设备命名示例
建议为您的设备提供描述性的名称，以便AI助手更容易控制。例如：
- 使用“卧室窗帘”而不是仅仅使用“窗帘”
- 使用“客厅空调”而不是仅仅使用“空调”
- 使用“厨房咖啡机”而不是仅仅使用“机器人”
这种命名约定有助于AI助手理解每个设备的上下文和位置。
支持的操作
设备管理
- 列出设备
- 获取设备状态
- 开关设备
- 更改设备设置
场景管理
- 列出场景
- 执行场景
传感器信息
- 温度
- 湿度
- 亮度
- 移动检测
开发
# Build
npm run build
# Development mode (TypeScript)
npm run dev
# Start
npm start
故障排除
设备无响应
- 确认设备在蓝牙范围内
- 检查设备电池状态
- 确认SwitchBot集线器连接状态
认证错误
- 检查token和密钥是否过期
- 重新生成token和密钥
- 更新环境变量
许可证
ISC
