Whoop MCP Server

基本能力

产品定位

Whoop MCP Server 是一个用于访问 Whoop API 数据的中间件服务，主要用于健康数据分析和监控。

核心功能

1. 周期查询
2. get_cycle_collection(start_date: str, end_date: str): 获取特定日期范围内的周期数据

3. get_latest_cycle(): 获取最新的周期数据

4. 恢复和压力数据

5. get_recovery_data(start_date: str, end_date: str): 获取特定日期范围内的恢复数据
6. get_strain_data(start_date: str, end_date: str): 获取特定日期范围内的压力数据

7. get_average_strain(days: int = 7): 计算指定天数内的平均压力

8. 用户配置和认证

9. get_profile(): 获取用户配置文件信息
10. check_auth_status(): 检查与 Whoop API 的认证状态

适用场景

1. 健康数据分析
2. 个人健康监控
3. 运动表现评估
4. 恢复状态跟踪

工具列表

1. Cycle Queries: 提供周期数据查询功能
2. Recovery and Strain: 提供恢复和压力数据查询功能
3. Profile and Authentication: 提供用户配置和认证状态检查功能

常见问题解答

1. 日期格式错误: 日期应提供 ISO 格式 (YYYY-MM-DD)
2. API 认证错误: 确保提供正确的 Whoop 凭证
3. 网络连接问题: 检查网络连接是否正常
4. 凭证缺失或无效: 确保环境变量中设置了正确的 WHOOP_EMAIL 和 WHOOP_PASSWORD

使用教程

使用依赖

1. Python 3.12
2. Whoop 账户凭证

安装教程

1. 克隆项目仓库
2. 安装依赖:

pip install -r requirements.txt

1. 配置环境变量:

export WHOOP_EMAIL="[email protected]"
export WHOOP_PASSWORD="your_password"

调试方式

1. 运行 HTTP API 服务器:

./run_whoop_server.sh

1. 测试查询:

curl http://localhost:8000/get_latest_cycle

1. 检查日志以获取错误信息

许可证

该项目遵循 MIT 开源许可条款。