juggle-mcp

juggle-mcp

面向家庭账户的 Juggle MCP 服务。Juggle 是保姆和宠物看护服务平台。可查看您的看护需求及申请者、看护人员资料和评价、消息，还可进行需确认的预订变更。

由 AI（Claude Code）开发和维护。与 Juggle 无关联。 该网站没有公开 API；此服务会使用您的电子邮件和密码登录，并调用与网站相同的路由。这些路由根据网站的 JavaScript 映射而来。所有读取工具以及收藏 / 取消收藏操作均已通过已登录的家庭账户验证（2026-11-03）；其他写入操作（发布看护需求、接受 / 拒绝看护人员、取消、发送消息、评价）会影响他人，尚未在实际环境中验证——请参阅 docs/JUGGLE-API.md。

设置

npx -y @chrischall/juggle-mcp

变量	必填	说明
JUGGLE_EMAIL	是	您用于登录 whyjuggle.com 的电子邮件地址（家庭账户）。
JUGGLE_PASSWORD	是	您的 whyjuggle.com 密码。暂不支持仅使用 Google / Facebook 登录的账户——请先在网站上设置密码。
JUGGLE_BASE_URL	否	覆盖网站源地址，仅用于测试 / 本地存根。默认为 https://whyjuggle.com；必须使用 https（允许回环地址使用 http）。
MCP_CONFIRM_MODE	否	在不支持提示词的客户端（claude.ai、Claude Desktop）上控制需确认的写入操作：ask-user（默认）——首次调用不会发送任何内容，而是返回预览和 confirmToken；模型必须先获得您的批准，再携带该令牌重新调用；auto——模型查看预览后可使用该令牌；refuse——拒绝写入操作。
MCP_CONFIRM_ELICITATION	否	设置为 off 时，即使客户端声明支持征询，也会跳过确认提示。
MCP_CONFIRM_TTL_SECONDS	否	confirmToken 的有效时长（默认 600 秒）。

服务无需凭据即可启动（以便宿主列出其工具）；首次调用工具时会报告缺少哪些内容。密码被拒绝后不会自动重试。

工具

读取

工具	功能说明
juggle_healthcheck	检查 Juggle 登录是否已配置并通过验证，以及是否可以成功读取已验证页面
juggle_get_profile	你的家庭资料：账户、城市、会员资格、工作统计数据、已保存地址（发布一次临时看护的地址 ID）、宠物；仅在请求时返回孩子的信息
juggle_get_payments_summary	你的城市费率、已保存的银行卡（品牌／末 4 位）、会员资格、促销抵扣额和近期交易，金额以美元计
juggle_list_bookings	列出你的临时看护／工作：状态、服务、开始时间、已预约的临时看护人员、待处理申请；可按进行中、过往或状态筛选
juggle_get_booking	查看一项预约的详细信息：时间、孩子／宠物、备注、申请者和已预约的临时看护人员、付款总额、你可以执行的操作
juggle_list_sitters	按可服务时间段、服务、关键词或姓名搜索你所在城市的临时看护人员
juggle_list_favorites	列出你标记为收藏的临时看护人员。返回 returned（收藏人数）；如果 Juggle 的 200 人上限可能导致列表不完整，还会返回 note；从 0.1.1 起不再返回 totalNumSitters，因为它统计的是全市临时看护人员，而不是你的收藏
juggle_get_sitter	临时看护人员的公开资料：评分、经验、学校、认证、简介——绝不包含私人详情
juggle_get_reviews	其他家庭为某位临时看护人员留下的评价，以及评价总数和平均评分
juggle_list_conversations	你与临时看护人员的消息会话：最近一条消息、时间、未读数
juggle_get_conversation	读取一个会话中的消息，先显示最新的一页
juggle_list_locations	Juggle 提供服务的城市及公布的婴幼儿看护／宠物看护费率（无需登录）

读取工具接受 view 参数：compact（默认值）返回精简投影，full 和 raw 则返回更多上游字段。juggle_list_bookings 和 juggle_list_conversations 还接受 brief 参数（每项显示一行，供 mcp-host 的上下文分组使用；参见技能中的“In context groups”）。对于资料、临时看护人员和付款工具， 即使使用 raw，返回内容仍受隐私允许列表限制。临时看护人员资料行中的私人字段（电话、出生日期、紧急联系人、背景调查回答、社交账号）、家庭电话号码和房屋说明，以及付款页面上的 Stripe 密钥都不会返回。唯一的例外是预约：其中会显示已预约该次临时看护的人员的电话号码，与网站上的显示相同。只有使用 include_kids 时才会返回孩子的详细信息。返回他人文本的工具（消息、 评价、临时看护人员简介、预约备注）会将其标记为不可信内容。

写入（需确认）

工具	功能说明
juggle_post_job	发布一次性婴幼儿看护／宠物看护／在家辅导工作（临时看护），可选择邀请一位临时看护人员
juggle_accept_sitter	接受（预约）申请了你某项工作的临时看护人员
juggle_decline_sitter	拒绝申请你某项工作的临时看护人员
juggle_cancel_booking	取消预约；逾期取消只能接受一星评价的处罚，绝不支付费用
juggle_send_message	在你与临时看护人员的会话中发送文本消息
juggle_favorite_sitter	将一位临时看护人员添加到收藏
juggle_unfavorite_sitter	将一位临时看护人员从收藏中移除
juggle_leave_review	为已完成的预约中的临时看护人员留下 0–5 星（半星制）评价

每项写入操作的首次调用都不会发送任何内容。它会重新读取数据并返回 预览和 confirmToken。使用该令牌再次调用后，请求只会发送一次（参见上文的 MCP_CONFIRM_MODE）。发送后若发生 5xx 错误或连接中断，则会报告 status: "unknown"，且绝不重试。本工具范围不包括任何涉及资金的操作（小费、付款、取消费用、 订阅、礼品卡），逾期取消也绝不会支付费用。

技能（无需服务）

skills/juggle 是一个 curl + jq 辅助工具 （skills/juggle/scripts/juggle），可在 shell 中执行相同的读取操作。它可在 bash 或 zsh 下运行，会将自己的会话文件以 0600 权限保存在 ~/.config/juggle/session，并应用相同的隐私允许列表。它仅支持只读；写入操作仍由 MCP 处理。将此仓库安装为插件后，Claude Code 会自动发现它。

托管

可在 mcp-host（claude.ai 远程 MCP）上作为每位用户的连接器托管，无需 浏览器桥接，因为登录只需在服务器端通过 POST 提交电子邮件和密码。 mint.yaml 声明了 identity.perUserChild，并要求每位用户在授权页面输入 自己的 JUGGLE_EMAIL / JUGGLE_PASSWORD，因此不会涉及共享密钥。出站连接仅限 whyjuggle.com。此技能仅在本地运行：只要安装了 curl 和 jq，就可以在相应环境中运行。

开发

npm install
npm run build
npm test        # both typechecks + vitest (no network)

许可证

MIT