关键词

智能家居控制SwitchBot设备管理AI助手自动化

SwitchBot Server MCP 使用说明

项目简介

SwitchBot Server MCP 是一个 Model Context Protocol (MCP) 服务器，它使 AI 助手能够控制 SwitchBot 智能家居设备。通过此服务器，AI 助手可以列出设备、获取状态、控制开关和执行场景。

主要功能点

  • 设备列表：获取所有 SwitchBot 设备的列表。
  • 设备状态：查询特定设备的状态（如开关状态、温度、湿度等）。
  • 设备控制：控制设备开关状态。
  • 场景控制：执行预设的 SwitchBot 场景。
  • 设备状态监控：监控设备状态变化。

安装步骤

  1. 通过 Smithery 安装 (推荐 Claude Desktop 用户): 
    npx -y @smithery/cli install @genm/switchbot-mcp --client claude
  2. 手动安装: 
    npm install @genm/switchbot-mcp

服务器配置

要将 SwitchBot Server MCP 连接到 MCP 客户端（例如 Claude Desktop），您需要配置客户端以启动服务器。以下是在 'claude_desktop_config.json' 中配置服务器的示例：

{
  "mcpServers": {
    "switchbot": {
      "command": "node", // 启动命令，使用 Node.js 运行
      "args": ["path/to/switchbot-mcp/build/index.js"], // 启动参数，指向编译后的服务器入口文件
      "env": {
        "SWITCHBOT_TOKEN": "your_token", // SwitchBot API Token，请替换为你的 Token
        "SWITCHBOT_SECRET": "your_secret" // SwitchBot API Secret Key，请替换为你的 Secret Key
      }
    }
  }
}

配置参数说明:

  • 'server name': 'switchbot' (服务器名称，客户端用此名称引用服务器)
  • 'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
  • 'args': '["path/to/switchbot-mcp/build/index.js"]' (命令参数，指向 SwitchBot Server MCP 的入口文件。请将 'path/to/switchbot-mcp' 替换为实际安装路径)
  • 'env': 环境变量配置
    • 'SWITCHBOT_TOKEN': 您的 SwitchBot API Token，需要从 SwitchBot App 的开发者选项中获取。
    • 'SWITCHBOT_SECRET': 您的 SwitchBot API Secret Key，同样从 SwitchBot App 的开发者选项中获取。

获取 SwitchBot API Token 和 Secret Key:

  1. 安装 SwitchBot App 并创建账户登录。
  2. 进入 "Profile" (个人资料) -> "Settings" (设置) -> "Developer Options" (开发者选项)。
  3. 获取 "Token" 和 "Secret key"。

基本使用方法

  1. 确保 MCP 服务器已成功启动，并已在 MCP 客户端中正确配置。
  2. 在支持 MCP 协议的 AI 客户端中，可以使用自然语言指令来调用 SwitchBot Server MCP 提供的工具，例如：
    • 请求 AI 助手列出所有 SwitchBot 设备。
    • 请求 AI 助手查询特定 SwitchBot 设备的状态。
    • 指示 AI 助手控制 (打开/关闭) 某个 SwitchBot 设备。
    • 指示 AI 助手执行预设的 SwitchBot 场景。

设备命名建议:

为了使 AI 助手更容易理解和控制您的设备，建议使用描述性名称，例如 "卧室窗帘" 而不是 "窗帘"，"客厅空调" 而不是 "空调"。

信息

分类

桌面与硬件

访问项目