SwitchBot MCP Server

日本語はこちら

SwitchBot MCP Server 是一个 Model Context Protocol (MCP) 服务器，它提供了一个使用 SwitchBotAPI 交互控制 SwitchBot 设备的功能。

使用场景

• 交互式操作 SwitchBot 设备
• 同时对多个设备执行操作
• 使用从一个设备获取的数据来操作另一个设备

安装

准备密钥和令牌

按照 SwitchBotAPI 的入门指南 获取 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"
      }
    }
  }
}

使用二进制文件

<details> <summary>详情</summary>

从 发布页面 下载二进制文件。

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

</details>

可用工具

可以检索设备、检索状态以及在设备上执行命令。

工具名称	描述
get_switch_bot_devices	获取 SwitchBot 设备
get_switch_bot_device_status	获取 SwitchBot 设备状态
execute_command	在设备上执行命令