Ruru Swbot

SwitchBot API の MCP サーバー。デバイスを名前で操作できる設計なので、AIがIDを間違えて操作を失敗するリスクがあんまりなかったりします。

インストール

npm install -g ruru-swbot-mcp

環境変数

SwitchBot アプリの設定からトークンとシークレットを取得し、設定してください。

変数名	説明
SWITCHBOT_TOKEN	SwitchBot API トークン
SWITCHBOT_SECRET	SwitchBot API シークレット

MCP 設定

Claude Code

claude mcp add switchbot -- npx ruru-swbot-mcp

Claude Desktop

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