← 返回目录

Litter-Robot MCP Server

社区

用自然语言监控和控制 Whisker 自动化宠物设备。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 168 / 230
Stars: ★ 198 非常热门
传输方式: stdio（本地进程）
运行环境: Python
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 7 天前
工具数: 24

47FMRS · D

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

最强项 · 文档质量 12/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

9/20

维护活跃度

8/20

文档质量

12/20

安装易用性

11/20

查看各项评分依据

可靠性 7/20: README 描述了 MCP 安装、启动命令和工具分类，但未提供清单、源码、测试、CI 或初始化/工具列表握手证据，因此无法验证声明工具与实际行为是否一致，也缺少错误处理和依赖可控性的证据。按静态审查应扣分。
安全与权限 9/20: 文档明确说明需要 Whisker 账户凭据，并提醒配置文件以明文保存及设置文件权限；但服务器会访问外部 Whisker API，并提供启动清理、重置、喂食和设置修改等副作用操作。未见最小权限、工具级授权、确认机制、数据边界或网络数据流的实现证据，因此扣分；未发现提示中的红线风险。
维护活跃度 8/20: 项目未归档，声明使用 MIT 许可证，并显示有维护者支持渠道；但仅给出 186 个 star 和 2 个开放 issue，未提供发布记录、提交活动、依赖更新、测试状态或安全响应流程证据，因此只能给予中低分。
文档质量 12/20: README 覆盖项目用途、支持的设备、安装方式、认证示例、启动方式、客户端配置和工具名称，并披露了逆向工程及实验性限制；但没有完整工具参数、权限模型、失败处理、版本兼容性或排障说明，且 MCP 清单未缓存，无法核验声明能力。
安装易用性 11/20: README 提供 pip 安装、可选 MCP extra、模块启动命令和 Claude Desktop 配置示例，路径相对清晰；但要求用户手动准备 Python 环境、配置账户凭据，未说明平台兼容性、依赖版本、认证失败处理或可验证的端到端安装结果，因此扣分。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Python

LITTER_ROBOT_USERNAME 必填 Whisker 账户的登录邮箱（通常是 [email protected] 格式），即 Whisker 应用中使用的账号。

LITTER_ROBOT_PASSWORD 必填密钥 Whisker 账户的登录密码，来自你的 Whisker 应用凭据；明文存储在配置中，请注意文件权限。

安装包含 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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add litter-robot -e [email protected] -e LITTER_ROBOT_PASSWORD=your_password -- python -m pylitterbot.mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装 pylitterbot[mcp] 并在 Claude Desktop 中配置后，重启客户端并在工具列表中确认出现 get_robots、fleet_overview 等工具，然后询问“列出我的机器人”，若能返回 Whisker 设备名称即说明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我账户下所有的机器人并显示各自状态
现在对一台处于 READY 状态的猫砂盆启动清洁循环
给我一份所有机器人的维护预测，看看哪个快满了
把主卧猫砂盆的夜灯亮度调到 50

工具能力 24

get_robots 只读

获取账户关联的机器人列表。

get_robot_status 只读

获取机器人状态。

get_activity_history 只读

获取活动历史。

get_insight 只读

获取机器人洞察信息。

get_pets 只读

获取宠物信息。

start_cleaning 写入

启动清洁循环。

reset_robot 写入

重置机器人。

give_snack 写入

给宠物发放零食。

展开其余 16 个工具

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 只读

比较多个机器人的设置和指标。

使用场景

查看多个机器人及其当前状态。

通过自然语言启动清洁、重置机器人或发放零食。

调整夜灯、睡眠模式、等待时间和面板锁定等设置。

汇总活动、宠物使用情况、维护预测和故障诊断信息。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

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