@genm/switchbot-mcp
2025.02.28
0
JavaScript智能家居控制设备管理开发效率
switchbot-mcp 是一个 Model Context Protocol 服务器，为 AI 助手提供 SwitchBot 设备控制能力。它允许用户通过 AI 助手控制和管理 SwitchBot 设备，包括设备列表、状态获取、设备控制、场景控制等功能。
View on GitHub
Overview
基本能力
产品定位
switchbot-mcp 是一个为 AI 助手提供 SwitchBot 设备控制能力的 MCP 服务器。
核心功能
- 列出设备
- 获取设备状态
- 控制设备（开/关）
- 更改设备设置
- 场景控制
- 设备状态监控
适用场景
- 通过 AI 助手控制智能家居设备
- 自动化场景管理
- 设备状态监控
工具列表
- SwitchBot API：用于与 SwitchBot 设备通信
- Smithery：用于自动安装和管理 MCP 服务器
常见问题解答
设备无响应
- 确认设备在蓝牙范围内
- 检查设备电池状态
- 确认 SwitchBot 集线器连接状态
认证错误
- 检查令牌和密钥是否过期
- 重新生成令牌和密钥
- 更新环境变量
使用教程
使用依赖
- 安装 SwitchBot 应用
- 创建账户并登录
- 进入 Profile > Settings > Developer Options
- 获取令牌和密钥
安装教程
通过 Smithery 安装
npx -y @smithery/cli install @genm/switchbot-mcp --client claude
手动安装
npm install @genm/switchbot-mcp
调试方式
# 构建
npm run build
# 开发模式 (TypeScript)
npm run dev
# 启动
npm start