@genm/switchbot-mcp

SwitchBot MCPサーバーは、AIアシスタントにSwitchBotデバイスの制御機能を提供するMCPサーバーです。

機能

デバイス一覧の取得
デバイスの状態取得
デバイスの制御（オン/オフ）
デバイスの設定変更
シーン制御
デバイスステータス監視

インストール

npm install @genm/switchbot-mcp

セットアップ手順

1. SwitchBot APIの設定

SwitchBotアプリをインストール
アカウントを作成してログイン
アプリのプロフィール画面から「設定」→「開発者向けオプション」を開く
トークンを取得

2. MCPサーバー設定

recline_mcp_settings.jsonまたはclaude_desktop_config.jsonに以下の設定を追加：

{
  "mcpServers": {
    "switchbot": {
      "command": "node",
      "args": ["path/to/switchbot-mcp/build/index.js"],
      "env": {
        "SWITCHBOT_TOKEN": "your_token"
      }
    }
  }
}

3. 環境変数

SWITCHBOT_TOKEN=your_token

サポートしているデバイス

プラグ
ボット
カーテン
エアコン
加湿器
ライト
リモコン

サポートしている操作

デバイス管理

デバイスの一覧取得
デバイスのステータス取得
デバイスの電源オン/オフ
デバイスの設定変更

シーン管理

シーンの一覧取得
シーンの実行

センサー情報

温度
湿度
明るさ
モーション

開発

# ビルド
npm run build

# 開発モード（TypeScript）
npm run dev

# 起動
npm start

エラー対処

デバイスが応答しない場合

デバイスがBluetooth範囲内にあることを確認
デバイスのバッテリー状態を確認
SwitchBotハブとの接続状態を確認

認証エラー

トークンの有効期限を確認
トークンを再生成
環境変数を更新

ライセンス

ISC