Switchbot

🚀 @genm/switchbot-mcp

このプロジェクトは、SwitchBotデバイスの制御機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントがSwitchBotデバイスを制御できるようになります。

日本語版

🚀 クイックスタート

このサーバーを使用することで、AIアシスタントがSwitchBotデバイスを制御できるようになります。以下に、主な機能やインストール方法、設定方法などを説明します。

✨ 主な機能

• デバイスの一覧表示
• デバイスの状態取得
• デバイスの制御（オン/オフ）
• デバイスの設定調整
• シーン制御
• デバイスの状態監視

📦 インストール

Smitheryを使用したインストール

Smitheryを通じて、SwitchBot MCPサーバーをClaude Desktopで自動インストールします。

npx -y @smithery/cli install @genm/switchbot-mcp --client claude

手動インストール

npm install @genm/switchbot-mcp

📚 ドキュメント

1. SwitchBot APIの設定

1. SwitchBotアプリケーションをインストールします。
2. アカウントを作成し、ログインします。
3. プロフィール > 設定 > 開発者オプションに移動します。
4. トークンとキーを取得します。

2. MCPサーバーの設定

claude_desktop_config.jsonに以下の内容を追加します。

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

3. 環境変数の設定

SWITCHBOT_TOKEN=your_token
SWITCHBOT_SECRET=your_secret

対応デバイス

• コンセント
  • リビングの床灯
  • オフィスのパソコン電源
• ロボット
  • キッチンのコーヒーメーカー
  • リビングの空気清浄機
• カーテン
  • ベッドルームの窓飾り
  • 書斎の遮光カーテン
• エアコン
  • リビングのエアコン
  • ベッドルームのエアコン
• 加湿器
  • ベッドルームの加湿器
  • 書斎の加湿器
• 照明器具
  • キッチンの主灯
  • ベッドルームの夜灯
• リモコンデバイス
  • リビングのテレビ
  • 書斎の扇風機

デバイスの命名例

AIアシスタントが理解しやすいように、デバイスに説明的な名前を付けることをおすすめします。例えば：

• “ベッドルームのカーテン” の方が “カーテン” よりも良い
• “リビングのエアコン” の方が “エアコン” よりも良い

このような命名習慣は、AIアシスタントがデバイスの位置や用途を識別するのに役立ちます。

サポートされる操作

デバイス管理

• デバイスの一覧表示
• デバイスの状態取得
• デバイスのオン/オフ制御
• デバイスの設定調整

シーン管理

• シーンの一覧表示
• シーンの実行

センサー情報

• 温度
• 湿度
• 明るさ
• 動き検知

開発方法

# ビルド
npm run build

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

# 起動
npm start

トラブルシューティング

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

1. デバイスがBluetoothの範囲内にあることを確認します。
2. デバイスのバッテリー状態を確認します。
3. SwitchBotリピーターの接続状態を確認します。

認証エラーが発生した場合

1. トークンとキーの有効期限を確認します。
2. トークンとキーを再生成します。
3. 環境変数を更新します。

📄 ライセンス

ISC