whoop-mcp 是一个本地优先的 MCP（Model Context Protocol）服务器，用于把 AI 智能体连接到用户的 WHOOP 恢复、睡眠、负荷与 HRV 数据。它面向使用 Claude、Cursor、Hermes、OpenClaw 或其他兼容 MCP 的智能体的用户，目的是让智能体在思考训练、睡眠和恢复时无需从 WHOOP App 中复制粘贴数字。该项目为非官方项目，与 WHOOP, Inc. 无关联、未获其认可或支持，仅限用户使用自己的 WHOOP 账户并遵守 WHOOP 开发者条款。
用途与定位 WHOOP 提供丰富的生理数据——恢复分数、HRV、睡眠阶段、负荷——但这些数据位于 OAuth API 和封闭应用之后。要将其接入 AI 智能体，通常需要自行实现 OAuth 流程、安全存储令牌、规范化响应并处理分页。whoop-mcp 在本地完成这些工作，通过 MCP 暴露 WHOOP 数据，并允许任何兼容 MCP 的智能体通过一段配置片段读取 WHOOP 上下文。令牌不会离开用户机器。
主要能力 该服务器提供以下类别的工具与资源：
- 数据可用性与入门：whoop_demo（无需 OAuth 的合成恢复/睡眠/负荷数据，带有 is_demo: true 标记）、whoop_connection_status（在调用 WHOOP 前验证本地设置）、whoop_data_inventory（盘点支持的数据域、权限范围、隐私模式和推荐首次调用，不调用 WHOOP API）。
- 摘要：whoop_daily_summary（当日准备度、睡眠、负荷和行动候选项）、whoop_weekly_summary（计分卡、与前一周对比、下周计划）。
- 认证与诊断：whoop_capabilities、whoop_agent_manifest、whoop_privacy_audit、whoop_cache_status、whoop_get_auth_url、whoop_exchange_code、whoop_revoke_access、whoop_get_profile、whoop_get_body_measurements。
- 集合（分页，支持 start/end 过滤与隐私模式覆盖）：whoop_list_recoveries、whoop_list_sleeps、whoop_list_cycles、whoop_list_workouts。常用参数包括 start、end、limit（最大 25）、next_token、all_pages、max_pages、response_format（markdown/json）、privacy_mode（summary/structured/raw）。
- 单条记录查询：whoop_get_cycle、whoop_get_sleep、whoop_get_workout、whoop_get_cycle_sleep、whoop_get_cycle_recovery。
- 面向场景的工具：whoop_daily_performance_coach（基于当日信号给出实用每日计划）、whoop_weekly_training_review（周对比与下周计划）、whoop_sleep_recovery_investigator（研究睡眠与恢复模式）。各工具接受时区参数（IANA，默认 UTC）。
- 资源：whoop://capabilities、whoop://summary/daily、whoop://summary/weekly、whoop://latest/recovery、whoop://latest/sleep、whoop://latest/cycle。
使用方式 安装：可使用 Delx Wellness for Hermes 的一条命令安装：npx -y delx-wellness-hermes setup——它会在专用 Hermes 配置文件中预配置此连接器及完整 Delx Wellness 栈。也可独立接入 Claude Desktop / Cursor / ChatGPT Desktop。对于 Claude Desktop，运行 setup --client claude 会自动写入配置片段。默认使用 stdio 传输；可选 Streamable HTTP（无会话 id、JSON 响应、仅限回环），环境变量为 WHOOP_MCP_HOST、WHOOP_MCP_PORT、WHOOP_MCP_TRANSPORT=http。设置需要用户创建 WHOOP 开发者应用，重定向 URI 为 http://127.0.0.1:3000/callback。OAuth 令牌存储在 ~/.whoop-mcp/tokens.json（0600 权限），刷新令牌轮换使用锁文件避免并发刷新竞争。whoop_revoke_access 是唯一破坏性工具，会删除本地令牌并撤销授权。WHOOP_PRIVACY_MODE 默认为 structured，原始 WHOOP API 负载需通过 raw 模式或按调用覆盖选择加入。演示捕获工具 demo-capture 可生成隐私脱敏的转录，用于 README 演示、issue 更新或智能体评估，并在设置不完整时安全失败，脱敏器会阻止 OAuth 密钥、本地令牌路径、原始负载、精确恢复数字和精确睡眠细节。
适用场景与限制 适用于希望让 AI 智能体结合自身 WHOOP 恢复、睡眠、负荷和 HRV 数据来辅助训练、睡眠与恢复决策的个人用户。限制包括：使用官方 WHOOP OAuth API（v2），不访问原始设备传感器流；README 中的 raw 指受支持端点的上游 WHOOP API JSON，而非原始传感器样本；需要用户自己的 WHOOP 开发者应用与账户；非官方项目，与 WHOOP, Inc. 无关；软件按现状提供，不是医疗设备，不提供医疗建议，不得用于诊断或治疗；平台支持、收费、价格等信息暂未提供。
项目由 David Mosiah 构建，属于 Delx Wellness（本地优先健康 MCP 连接器注册表）的一部分。它建立在 Shashank Mishra 先前的 WHOOP MCP 工作之上，包括 OAuth/WHOOP API 方向及更早的 MIT 许可 whoop-ai-mcp 包。MIT 许可，详见 LICENSE。
