SwitchBot MCP Server

June 21, 2025 · View on GitHub

Go Report Card Coverage Code to Test Ratio Test Execution Time

English version is here.

SwitchBot MCP ServerはSwitchBotAPIを使用してSwitchBotのデバイスを会話で操作できる機能を提供するModel Context Protocol (MCP)をサーバです。

使用例

  • SwitchBotのデバイスを対話を通して操作する
  • 複数のデバイスに対する操作を一度に行う
  • デバイスから取得したデータを元に別のデバイスの操作を行う

インストール方法

シークレットとトークンの準備

SwitchBotAPIのGetting Startedに従って、SwitchBotAPIのトークンとシークレットを取得してください。

Claude Desktopで使用する場合の設定

Dockerを使用する(推奨)

{
  "mcpServers": {
    "switchbot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--name",
        "switch-bot-mcp-server",
        "-e",
        "SWITCH_BOT_TOKEN",
        "-e",
        "SWITCH_BOT_SECRET",
        "yasu89/switch-bot-mcp-server:latest"
      ],
      "env": {
        "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
        "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
      }
    }
  }
}

バイナリを使用する

詳細

リリースページからダウンロードしてください。

{
  "mcpServers": {
    "switchbot": {
      "command": "~/Downloads/switch-bot-mcp-server",
      "env": {
        "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
        "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
      }
    }
  }
}

利用可能なツール

デバイスの取得とステータスの取得、デバイスのコマンドの実行が利用可能です。

Tool NameDescription
get_switch_bot_devicesGet SwitchBot devices
get_switch_bot_device_statusGet SwitchBot device status
execute_commandExecute a command on a device