remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides connectivity for SwitchBot devices which operate over Bluetooth, allowing device control for devices within Bluetooth range.

@genm/switchbot-mcp

为 AI 助手提供 SwitchBot 设备控制功能的模型上下文协议服务器。

日语

特征

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

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 SwitchBot MCP 服务器：

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

手动安装

npm install @genm/switchbot-mcp

设置

1. SwitchBot API 配置

安装 SwitchBot 应用程序
创建帐户并登录
前往“个人资料”>“设置”>“开发者选项”
获取令牌和密钥

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

支持的设备

插头
- 客厅落地灯
- 办公室电脑电源
机器人
- 厨房咖啡机
- 客厅空气净化器
窗帘
- 卧室窗帘
- 书房遮光窗帘
空调
- 客厅空调
- 卧室空调
加湿器
- 卧室加湿器
- 书房加湿器
光
- 厨房天花板灯
- 卧室夜灯
遥控
- 客厅电视
- 书房风扇

设备名称示例

建议为设备指定描述性名称，以便 AI 助手更轻松地控制。示例：

“卧室窗帘”而不仅仅是“窗帘”
“客厅空调”而非“空调”
“厨房咖啡机”而不仅仅是“机器人”

这种命名约定有助于人工智能助手了解每个设备的上下文和位置。

支持的操作

设备管理

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

场景管理

列出场景
执行场景

传感器信息

温度
湿度
亮度
运动

发展

# Build
npm run build

# Development mode (TypeScript)
npm run dev

# Start
npm start

故障排除

设备无响应

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

身份验证错误

检查令牌和密钥过期
重新生成令牌和密钥
更新环境变量

执照

国际学习中心

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

使AI助手能够控制SwitchBot设备，通过SwitchBot API提供设备管理、场景执行和传感器信息监控等功能。

Related Resources

Reddit Discussion about this server

SwitchBot MCP Server