AI 开发者工具
sharkclean-mcp
用于SharkClean/SharkNinja机器人吸尘器的MCP服务器,通过任意MCP客户端实现代理控制:用自然语言启动清洁、清洁房间、回充和检查状态。
sharkclean-mcp
什么是 sharkclean-mcp?
sharkclean-mcp是一个MCP服务器,允许AI代理通过自然语言命令控制SharkClean机器人吸尘器。它与SharkNinja的云后端通信,以启动清洁、清洁特定房间、回充和监控状态。
如何使用 sharkclean-mcp?
- 1克隆仓库并进入其目录。
- 2运行 'uv sync' 安装依赖。
- 3将 .env.example 复制为 .env 并添加你的 SharkClean 应用邮箱和密码。
- 4运行 'uv run shark-mcp-auth' 进行一次浏览器登录。
- 5使用 'uv run shark-mcp-doctor' 验证设置。
- 6使用提供的命令将 MCP 服务器注册到你的客户端(例如 Claude Code 或 Claude Desktop)。
sharkclean-mcp 主要功能
- 列出账户上的机器人
- 获取实时状态(清洁中/已暂停/已回充、电量、充电中、错误)
- 启动全屋清洁(可选功率模式)
- 列出机器人地图中的房间
- 清洁特定房间
- 暂停、恢复或停止清洁
- 让机器人返回基座
- 设置功率模式(节能/正常/最大)
- 通过蜂鸣定位机器人
sharkclean-mcp 使用场景
- 通过AI助手启动最大功率清洁
- 使用自然语言吸尘厨房和客厅
- 检查机器人状态和电量
- 清洁后将机器人送回基座
- 在脚本或定时任务中自动化清洁任务
sharkclean-mcp 价格与免费额度
sharkclean-mcp 目前采用 免费 模式。
sharkclean-mcp 优缺点
优点
- 兼容旧版SDK不支持的新款机器人
- 使用MCP协议进行AI集成
- 开源并附带清晰的文档
- 支持多机器人账户
缺点
- 非官方,与SharkNinja无关联
- 由于Auth0限制,需要一次浏览器登录
- Auth0令牌可能过期,需要重新认证
- 房间定位需要机器人已完成地图构建
sharkclean-mcp 最适合哪些用途?
- 将SharkClean吸尘器集成到AI工作流中的开发者
- 使用兼容MCP客户端的家庭自动化爱好者
- 拥有新款SharkNinja机器人吸尘器的用户