使用说明
ruru swbot mcp
SwitchBot API的MCP服务器。因为是可以用名字操作设备的设计,所以AI没有弄错ID而操作失败的风险。
安装
npm install -g ruru-swbot-mcp
环境变数
SwitchBot应用程序的设置求值时使用曲面法线的原始方向。
| 变数名 | 说明 |
|---|---|
SWITCHBOT_TOKEN SwitchBot API令牌 |
|
SWITCHBOT_SECRET SwitchBot API秘密 |
MCP设定
克劳德代码
claude mcp add switchbot -- npx ruru-swbot-mcp
克劳德桌面版
{
"mcpServers": {
"switchbot": {
"command": "npx",
"args": ["ruru-swbot-mcp"],
"env": {
"SWITCHBOT_TOKEN": "<your-token>",
"SWITCHBOT_SECRET": "<your-secret>"
}
}
}
}
资源
资源名称|URI|说明|
| --- | --- | --- |
| device_statuses | switchbot://devices/status |所有物理设备的当前状态(温度、湿度、电源等)|
工具
工具名称|说明|
| --- | --- |
| list_devices 获取设备列表(名称、类型、可用命令)
| get_device_status 获取设备的当前状态
| control_device 向设备发送命令
| list_scenes 获取场景列表
| execute_scene 执行场景
用法示例
1. list_devices でデバイス一覧を確認
2. get_device_status({ deviceName: "リビング照明" }) で状態を取得
3. control_device({ deviceName: "リビング照明", command: "turnOn" }) で操作