mcpField
S
Switch Bot Mcp Server

Switch Bot Mcp Server

本地服务
github.com/yasu89其他771 周前更新
代码仓库

关于 Switch Bot Mcp Server

Switch Bot Mcp Server 通过 SwitchBotAPI 控制 SwitchBot 设备，适用于需要交互式设备操作的场景。它提供设备查询、状态读取和命令执行，也支持多设备联动操作。

主要功能

  1. 01查询 SwitchBot 设备
  2. 02读取设备状态
  3. 03执行设备命令
  4. 04同时操作多个设备

适用场景

  1. 01查看 SwitchBot 设备状态
  2. 02一次操作多个设备
  3. 03依据一台设备的数据操作另一台

MCP 相关

向 MCP 客户端提供 SwitchBot 设备查询、状态读取和命令执行工具。

#go#golang#mcp#switchbot#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "switch-bot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SWITCH_BOT_TOKEN",
        "-e",
        "SWITCH_BOT_SECRET",
        "yasu89/switch-bot-mcp-server:latest"
      ],
      "env": {
        "SWITCH_BOT_TOKEN": "<SWITCH_BOT_TOKEN>",
        "SWITCH_BOT_SECRET": "<SWITCH_BOT_SECRET>"
      }
    }
  }
}
启动命令docker run -i --rm -e SWITCH_BOT_TOKEN -e SWITCH_BOT_SECRET yasu89/switch-bot-mcp-server:latest
需要配置的环境变量
SWITCH_BOT_TOKEN密钥
SWITCH_BOT_SECRET密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ociyasu89/switch-bot-mcp-server:latest

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

SwitchBot MCP 服务

Go Report Card Coverage Code to Test Ratio Test Execution Time

日文版请见此处

SwitchBot MCP 服务是一款 模型上下文协议（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"
      }
    }
  }
}
使用二进制文件
详情

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

{
  "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 设备状态
execute_command在设备上执行命令

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。