SwitchBot设备控制API

通过名称操作SwitchBot设备的API服务,降低AI误操作风险。

  • by arrow2nd
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 arrow2nd/ruru-swbot-mcp

使用说明

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" }) で操作