SwitchBot MCP

@genm/switchbot mcp

一个模型上下文协议服务器，为AI助手提供SwitchBot设备控制功能。 ](https://smithery.ai/server/@genm/switchbot-mcp)

日本语

特性

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

安装

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的SwitchBot MCP服务器 史密瑟里:

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

手动安装

npm install @genm/switchbot-mcp

设置

1.SwitchBot API配置

1. 安装SwitchBot应用程序
2. 创建帐户并登录
3. 转到“个人资料”>“设置”>“开发人员选项”
4. 获取令牌和密钥

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

故障排除

设备没有响应

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

身份验证错误

1. 检查令牌和密钥过期情况
2. 重新生成令牌和密钥
3. 更新环境变量

许可证

国际协调委员会