m5-petit-switchbot

SwitchBot Cloud API（v1.1）をラップするMCPサーバー。プラグ・照明・カーテン・赤外線リモコンなどを操作できる。

セットアップ

1. SwitchBotアプリ → プロフィール → 設定 → アプリバージョンを10回タップ → 「開発者向けオプション」が出現

2. そこから Token と Secret を取得

3. .env.example を参考に環境変数 SWITCHBOT_TOKEN / SWITCHBOT_SECRET を設定

Related MCP server: Smart Home MCP Server

ツール

デバイスIDは list_devices で調べる。

キャラクターへの登録例

$PETIT_DATA_DIR/characters/<id>/config/autonomous-mcp.json の mcpServers に追加:

"switchbot": {
  "command": "uv",
  "args": ["run", "--directory", "/path/to/m5-petit-switchbot", "switchbot-mcp"],
  "env": {
    "SWITCHBOT_TOKEN": "...",
    "SWITCHBOT_SECRET": "..."
  }
}

SWITCHBOT_ALLOWED_TOOLS（カンマ区切り）で使えるツールを制限できる（m5-petit-mcp と同じ仕組み）。

ライセンス

Apache-2.0。PetitOnes の部品のひとつ。全体の入口は petit-ones。