@genm/switchbot-mcp

一个模型上下文协议服务器，为 AI 助手提供 SwitchBot 设备控制能力。

日本語

<a href="https://glama.ai/mcp/servers/k8m7mttrur"><img width="380" height="200" src="https://glama.ai/mcp/servers/k8m7mttrur/badge" alt="SwitchBot Server MCP server" /></a>

功能

• 列出设备
• 获取设备状态
• 控制设备（开/关）
• 更改设备设置
• 场景控制
• 设备状态监控

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 SwitchBot MCP Server：

npx -y @smithery/cli install @genm/switchbot-mcp --client claude

手动安装

npm install @genm/switchbot-mcp

设置

1. SwitchBot API 配置

1. 安装 SwitchBot 应用程序
2. 创建一个帐户并登录
3. 转到 Profile > Settings > Developer Options
4. 获取 token 和 secret key

2. MCP 服务器配置

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "switchbot": {
      "command": "node",
      "args": ["path/to/switchbot-mcp/build/index.js"],
      "env": {
        "SWITCHBOT_TOKEN": "your_token",
        "SWITCHBOT_SECRET": "your_secret"
      }
    }
  }
}

3. 环境变量

SWITCHBOT_TOKEN=your_token
SWITCHBOT_SECRET=your_secret

支持的设备

• 插座
  • 客厅落地灯
  • 办公室 PC 电源
• 智能按钮
  • 厨房咖啡机
  • 客厅空气净化器
• 窗帘
  • 卧室窗帘
  • 书房遮光窗帘
• 空调
  • 客厅空调
  • 卧室空调
• 加湿器
  • 卧室加湿器
  • 书房加湿器
• 灯
  • 厨房吸顶灯
  • 卧室夜灯
• 遥控器
  • 客厅电视
  • 书房风扇

设备名称示例

建议为您的设备提供描述性名称，以便 AI 助手更容易控制。 示例：

• "卧室窗帘" 而不是仅仅 "窗帘"
• "客厅空调" 而不是仅仅 "空调"
• "厨房咖啡机" 而不是仅仅 "智能按钮"

这种命名约定有助于 AI 助手理解每个设备的上下文和位置。

支持的操作

设备管理

• 列出设备
• 获取设备状态
• 打开/关闭设备
• 更改设备设置

场景管理

• 列出场景
• 执行场景

传感器信息

• 温度
• 湿度
• 亮度
• 运动

开发

# 构建
npm run build

# 开发模式 (TypeScript)
npm run dev

# 启动
npm start

故障排除

设备无响应

1. 验证设备是否在蓝牙范围内
2. 检查设备电池状态
3. 验证 SwitchBot 集线器连接状态

身份验证错误

1. 检查 token 和 secret key 是否过期
2. 重新生成 token 和 secret key
3. 更新环境变量

许可证

ISC