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