whoop

Name: whoop
Author: shashankswe2020-ux

本地服务

github.com/shashankswe2020-ux健康医疗1753 天前更新

代码仓库

关于 whoop

whoop 是只读 MCP 服务，可让用户通过兼容的助手查看 WHOOP 健康与训练记录。它提供个人基线、趋势、摘要和赛事表现分析；本地工具还支持赛事记录、训练修正和仪表板。

主要功能

01读取恢复、睡眠和训练数据
02比较趋势与个人基线
03生成健康回顾摘要
04分析 HYROX 和铁人三项表现
05审计并修正本地赛事数据
06打开本地表现仪表板

适用场景

01回顾本周恢复和睡眠
02将 HRV 与个人基线比较
03跟踪 HYROX 或铁人三项训练
04检查并修正已记录的赛事数据

MCP 相关

向 MCP 客户端提供只读 WHOOP 数据工具、资源和提示词模板。本地 stdio 模式还支持赛事记录、训练修正和仪表板；远程连接需要部署服务并使用兼容连接器。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "shashankswe2020-ux-whoop": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-ai-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

启动命令npx -y whoop-ai-mcp

需要配置的环境变量

WHOOP_CLIENT_ID密钥Your WHOOP Developer App Client ID from developer.whoop.com

WHOOP_CLIENT_SECRET密钥Your WHOOP Developer App Client Secret from developer.whoop.com

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmwhoop-ai-mcp0.5.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

whoop-ai-mcp 是一款只读的 WHOOP MCP 服务，适用于 macOS 上的 Claude、Gemini CLI、Cursor、VS Code、OpenClaw、Perplexity，以及其他 MCP 客户端。询问恢复情况、比较数周的睡眠，或将今天的状况与自己的基准进行对比，无需自行导出数据。ChatGPT、Claude 网页版/移动版和 Grok xAI API 需要远程部署；请参阅客户端设置指南。

npx -y whoop-ai-mcp@latest setup --client=claude-desktop

快速开始 | 观看演示 | 网站 | 工具参考

Claude Desktop 中的 WHOOP MCP：每周健康回顾，包含恢复、HRV、睡眠和锻炼摘要
_{Claude Desktop 生成回顾；whoop-ai-mcp 提供数据。你的结果和布局可能有所不同。}

随心询问 WHOOP 数据

提问	获取内容
“我今天状态如何？”	恢复情况、主要睡眠、负荷和最近一次锻炼；缺失数据会特别标出
“我的 HRV 对我来说异常吗？”	个人基准：分布、百分位数，以及基于多少天的数据
“这个月我的睡眠有什么变化？”	趋势、周期比较、睡眠债和规律性
“给我一份每周健康回顾。”	一份摘要，涵盖恢复、睡眠和训练

统计数据反映你记录的历史，不是医疗诊断或预测。

快速开始

你需要： Node.js 20 或更高版本、有效的 WHOOP 会员资格，以及一个 WHOOP Developer App，其重定向 URL 为 http://localhost:3000/callback。

设置。 运行与你的助手对应的命令，并在提示时输入开发者应用的客户端 ID 和密钥。

助手	命令
Claude Desktop	`npx -y whoop-ai-mcp@latest setup --client=claude-desktop`
Claude Code	`npx -y whoop-ai-mcp@latest setup --client=claude-code`
Codex	`npx -y whoop-ai-mcp@latest setup --client=codex`
GitHub Copilot	`npx -y whoop-ai-mcp@latest setup --client=copilot`
Gemini CLI	`npx -y whoop-ai-mcp@latest setup --client=gemini-cli`
Cursor	`npx -y whoop-ai-mcp@latest setup --client=cursor`
VS Code	`npx -y whoop-ai-mcp@latest setup --client=vscode`
OpenClaw	`npx -y whoop-ai-mcp@latest setup --client=openclaw`
Perplexity（macOS 应用 + 辅助程序）	`npx -y whoop-ai-mcp@latest setup --client=perplexity`

对于 Claude Code、Codex 和 VS Code/Copilot，请运行 setup 输出的注册命令。对于 Gemini CLI、Cursor 和 OpenClaw，请合并输出的配置；对于 Perplexity，请将输出的启动命令粘贴到其本地连接器中。不会全局安装任何内容，可选的使用情况遥测默认设为否。

这些目标（包括 Desktop 的 claude 别名）要求版本为 1.1.0 或更高。如需从源码构建，请使用 node dist/index.js setup --client=<target>。

授权。 完全退出并重新打开助手。服务首次启动时，WHOOP 会在浏览器中打开，供你批准访问。
提问。 试试 “总结一下我本周的睡眠和恢复情况。”

需要手动配置、环境变量或远程部署？请参阅完整设置指南。

Claude 网页版/移动版和 ChatGPT 快速设置

运行 setup --client=claude-web 或 setup --client=chatgpt，使用任一实现输出远程部署和连接器说明。这些目标仅提供指导 ，并非一键托管：你需要提供公开的 HTTPS /mcp 端点，在主机上完成 WHOOP 授权，并配置兼容的连接器 OAuth。是否可用取决于客户端账号/工作区。运行 setup --client=grok 会输出一个 xAI API MCP 工具示例；尚未验证与面向消费者的 Grok 聊天集成。不会收集远程凭据，也不会测试客户端连接。

更倾向使用原生二进制文件？

Rust 实现提供相同的客户端目标和限制，且服务端无需 Node.js 运行时。它需要 Rust 1.88 或更高版本：

cargo install whoop-mcp
whoop-mcp setup --client=claude-desktop

额外的 Rust 目标要求版本为 0.2.0 或更高。如需从源码构建，请在 Rust 检出目录中使用 cargo run -- setup --client=<target>。

## 工作原理

你的 WHOOP 账户授权 whoop-ai-mcp 进行只读访问。它在你的计算机上运行，提供 16 个只读工具，且无需托管中继。它会将工具结果发送给你的 AI 助手：Claude Desktop、Claude Code、Codex 或 GitHub Copilot。

只读。 服务没有任何可创建、更改或删除 WHOOP 账户内容的工具。比赛结果和训练修正仅保存到本地文件，并附有审计日志。
默认在本地运行。 服务在你的设备上运行，不涉及托管中继。
你的助手可以看到结果。 健康数据会传给你使用的助手提供商，就像你在该聊天中分享的其他内容一样。
汇总模式将服务限制为五个摘要工具，并隐藏单条记录数据。它可以减少共享的数据，但并不等于匿名化。
只有选择加入后才会启用遥测。 遥测中绝不包含健康数据或聊天文本。

详情：数据处理和遥测控制。

包含内容

在标准模式下，服务提供 16 个只读工具、4 个资源和 5 个提示词模板，以及 9 个 HYROX 和铁人三项工具。对资源、提示词和远程连接的支持取决于你的助手。

HYROX 和铁人三项追踪

提问：“昨天的 HYROX 模拟赛表现如何？”或“两周后参加铁人三项，我准备好了吗？”比赛工具可以：

根据 WHOOP 中连续进行的训练重建 HYROX 训练课：分段时间线、转换时间、各心率区间时长和基于规则的分析。
追踪每周跑步和 HYROX 训练负荷、游泳／骑行／跑步的平衡与组合训练，以及已记录的比赛（包括各站和各赛段的分段成绩与个人最佳成绩）。
根据恢复、训练状态、专项性、睡眠负债和减量训练，给出一个准备度等级。每个组成部分都会显示其依据；不会给出不透明的分数。
让你审计数据：标记可疑训练记录，你可以重新标记或排除训练记录；每项更改都会记录，你还可以通过 verify_claim 重新计算助手告诉你的数值。
在 127.0.0.1 上打开以图表为先的本地仪表板（open_performance_dashboard），其中包含 Today、Session、Training、HYROX、Triathlon、Readiness 和 Audit 视图。仪表板还支持深色／浅色主题、本地字体，以及保存前审核控件。

以图表为先的 Session 视图：九个已记录的跑步和划船器分段、平均和峰值心率概况、逐段跑步进阶情况，以及已记录分段环形图。使用合成样例数据。

Readiness 视图：包含五部分依据的环形图、“尚未准备好”结论、各组成部分等级、理由和依据说明。使用合成样例数据。

Audit 视图：已标记训练记录卡片、基于规则的检查结果和修正控件。标记不会自动排除训练记录。使用合成样例数据。

_{截图使用合成样例数据。}

### 1.0.2 新增：图表优先的仪表盘

让你的助手**“打开我的表现仪表盘”，即可在本地启动。最新主分支重新设计的界面现已成为可用的仪表盘**，不再只是原型。默认使用深色模式，并提供浅色／深色切换，且会保留未保存的表单。默认视图仍为 Session。

今日： 恢复环形图，以及在同一时间轴上展示五周恢复、HRV、静息心率和睡眠阶段的图表，并共享十字准线。缺失日期仍显示为空档；历史区间反映的是你可见的数据，而非医学标准。
训练： 按 UTC 周展示 WHOOP 区间分钟数，包括无数据的周、运动负荷／时长气泡图，以及体能、疲劳和状态图表。本地修正会应用于此视图。
Session 和恢复状态： 展示已记录区段和五个组成部分的环形图、汇总心率图表及证据。不生成虚构的连续心率曲线或 HYROX 站点拆分数据。
保存前先检查。 检查运动修正和比赛结果，然后再编辑、取消或确认。保存失败时会保留你的输入。
保留你的上下文。 切换视图时会保留筛选条件；最近 7 天和最近 28 天预设使用已完成的 UTC 日期。
如实刷新。 刷新和重试控件会报告视图何时加载完成，而不是 WHOOP 何时同步。读取的数据可能来自缓存。

深色图表优先的今日仪表盘：恢复环形图，以及共享时间轴上的恢复、HRV、静息心率和睡眠阶段图表，并显示空档和历史区间。合成示例数据。
_{使用合成示例数据的今日视图。WHOOP 恢复状态并非比赛准备度的判定；本地运动修正会应用于比赛视图，而不会应用于此概览。}

训练仪表盘，展示每周记录的 WHOOP 区间分钟数、运动负荷和时长气泡图，以及体能、疲劳和状态。合成示例数据。

比赛日志、运动修正和仪表盘仅在服务于本地运行时（stdio）可用。详情请见：比赛表现工具和本地数据。

查看所有工具和提示词

分组	工具
今日和基线	`get_today`, `get_baselines`, `get_sleep_debt`
趋势和回顾	`get_weekly_summary`, `get_trend`, `compare_periods`, `get_calendar`
记录	`get_recovery_collection`, `get_sleep_collection`, `get_workout_collection`, `get_cycle_collection`, `get_sleep_by_id`, `get_workout_by_id`, `get_cycle_by_id`
个人资料	`get_profile`, `get_body_measurement`
HYROX 和铁人三项	`get_hyrox_session_report`, `get_hyrox_performance`, `get_triathlon_performance`, `get_race_readiness`, `audit_performance_data`, `verify_claim`
仅限本地：比赛日志、修正、仪表盘	`log_race_result`, `annotate_workout`, `open_performance_dashboard`

提示词模板： weekly_health_review, sleep_analysis, recovery_trend, workout_recap, health_check

参数、日期表达式、资源和缓存信息请参阅工具参考。

## 文档

指南	内容
安装	助手、手动配置、环境变量和 WHOOP 授权
工具参考	所有工具及其参数、日期表达式、资源、提示词和缓存
隐私	结构化结果、汇总模式，以及你的助手提供商会收到哪些信息
遥测	同意、退出方式、收集的数据及其保留时长
故障排除	本地诊断、常见错误和 MCP Inspector
部署	Docker、云托管和远程连接器 OAuth
开发	测试、项目结构和发布工作流
背景	生态研究和视频演示