← 返回目录
L

Litter-Robot MCP Server

社区
用自然语言监控和控制 Whisker 自动化宠物设备。
GitHub 源仓库 ↗
★ 187 Stars 分类 · 其他 非常热门 源版本 cfb00741137f
47FMRS · D
可靠性
7/20
安全与权限
9/20
维护活跃度
8/20
文档质量
12/20
安装易用性
11/20

这是一个由社区维护的非官方 pylitterbot MCP 服务器,提供 Whisker 设备的状态查询、活动分析、设置管理和部分控制操作。README 明确说明其 API 具有实验性,并提示凭据明文存储风险。

查看 FMRS 评分方法 →

Litter-Robot MCP Server 是 pylitterbot 提供的可选 MCP 服务器,用于通过自然语言监控和控制 Whisker 的联网自清洁猫砂盆与喂食器。目前支持 Litter-Robot 3(带 Connect)、Litter-Robot 4 和 Feeder-Robot。

工具能力

get_robots
获取账户关联的机器人列表。
get_robot_status
获取机器人状态。
get_activity_history
获取活动历史。
get_insight
获取机器人洞察信息。
get_pets
获取宠物信息。
start_cleaning
启动清洁循环。
reset_robot
重置机器人。
give_snack
给宠物发放零食。
set_power_status
设置电源状态。
set_name
设置机器人名称。
set_night_light
设置夜灯。
set_night_light_brightness
设置夜灯亮度。
set_night_light_mode
设置夜灯模式。
set_panel_lockout
设置面板锁定。
set_wait_time
设置等待时间。
set_sleep_mode
设置睡眠模式。
fleet_overview
汇总所有机器人的优先级状态与警报。
clean_all_ready
启动所有处于 READY 状态的机器人的清洁循环。
sync_settings
将一台机器人的设置复制到同型号的其他机器人。
pet_usage_report
结合宠物信息汇总所有机器人的活动数据。
maintenance_forecast
估算每台机器人需要清空的时间。
household_digest
生成指定时间范围内的家庭活动摘要。
troubleshooting_report
为机器人生成包含错误信息的诊断报告。
robot_comparison
比较多个机器人的设置和指标。

安装接入

安装包含 MCP 支持的额外依赖:pip install pylitterbot[mcp]。运行 pylitterbot-mcp,或运行 python -m pylitterbot.mcp。在 Claude Desktop 配置中使用示例命令,并设置 LITTER_ROBOT_USERNAME 与 LITTER_ROBOT_PASSWORD 环境变量。配置文件应限制为仅所有者可读写,且不要提交到版本控制。

claude_desktop_config.json
{"mcpServers":{"litter-robot":{"command":"python","args":["-m","pylitterbot.mcp"],"env":{"LITTER_ROBOT_USERNAME":"[email protected]","LITTER_ROBOT_PASSWORD":"your_password"}}}}

选型与风险

适合谁

  • 拥有受支持 Whisker 设备并希望通过 Claude Desktop 进行自然语言管理的用户。
  • 需要查看或管理多个 Litter-Robot 或 Feeder-Robot 的家庭。

不适合谁

  • 需要官方 Whisker API 或官方维护服务器的用户。
  • 使用 README 未列出的设备型号或需要 Litter-Robot 5 摄像头支持的用户。
  • 不愿提供 Whisker 账户凭据或接受实验性 API 风险的用户。

所需权限

  • 需要 Whisker 账户的用户名和密码。
  • 需要访问账户关联的机器人及其状态、活动、宠物和设置数据。
  • 控制类工具可能启动清洁、重置设备、发放零食或修改设备设置。

风险与副作用

  • 该 API 是通过监控网络流量和反编译 Whisker 应用程序逆向工程得到的非官方实验性 API,可能随时失效。
  • Claude Desktop 配置示例会以明文保存凭据,配置文件权限不当可能导致凭据泄露。
  • 控制工具会对真实宠物设备执行操作,使用时应确认目标机器人和操作。

常见排障

  1. 确认已安装 pylitterbot[mcp],而不是仅安装基础包。
  2. 确认使用 pylitterbot-mcp 或 python -m pylitterbot.mcp 启动服务器。
  3. 确认 LITTER_ROBOT_USERNAME 和 LITTER_ROBOT_PASSWORD 已正确设置。
  4. 确认 Claude Desktop 配置中的 command、args 和 JSON 格式正确。
  5. 确认设备属于 README 列出的受支持型号,并注意逆向 API 可能已发生变化或停止工作。

使用场景

查看多个机器人及其当前状态。
通过自然语言启动清洁、重置机器人或发放零食。
调整夜灯、睡眠模式、等待时间和面板锁定等设置。
汇总活动、宠物使用情况、维护预测和故障诊断信息。

支持客户端

Claude Desktop完整支持