返回 MCP 目录
public公开dns本地运行

switch-bot-mcp-server

SwitchBot MCP服务器是一个基于模型上下文协议(MCP)的服务,提供通过SwitchBot API交互控制智能设备的功能

article

README

🚀 SwitchBot MCP 服务器

SwitchBot MCP 服务器遵循 Model Context Protocol (MCP) 协议,借助 SwitchBotAPI 实现对 SwitchBot 设备的交互式控制,为设备操作带来便捷体验。

日本語版はこちら

🚀 快速开始

SwitchBot MCP 服务器提供了使用 SwitchBotAPI 交互式控制 SwitchBot 设备的功能。以下是使用该服务器的相关内容。

✨ 主要特性

  • 交互式操作:可对 SwitchBot 设备进行交互式操作。
  • 多设备控制:能够同时对多个设备执行操作。
  • 数据关联控制:可以利用一个设备的数据来控制另一个设备。

📦 安装指南

下载二进制文件

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

准备密钥和令牌

按照 SwitchBotAPI 的入门指南 获取 SwitchBotAPI 的令牌和密钥。

配置 Claude Desktop

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

📚 详细文档

可用工具

目前提供了一些基本功能,例如获取设备信息、查询状态以及执行开关操作。

| 工具名称 | 描述 | |-----------------------------|----------------------| | get_switch_bot_devices | 获取 SwitchBot 设备列表 | | get_switch_bot_device_status | 获取 SwitchBot 设备状态 | | turn_on_off_device | 开启或关闭设备 |

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端