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. Cycle Queries：用于查询周期数据
2. Recovery and Strain：用于获取恢复和压力数据
3. Profile and Authentication：用于用户配置和认证

常见问题解答

• 日期格式：日期应为 ISO 格式 (YYYY-MM-DD)
• 认证错误：确保提供正确的 Whoop 邮箱和密码
• 网络问题：检查网络连接是否正常

使用教程

使用依赖

1. 确保已安装 Python 3.12
2. 安装依赖： bash pip install -r requirements.txt

安装教程

1. 克隆项目仓库
2. 配置环境变量：
3. 在 config/.env 文件中设置 WHOOP_EMAIL 和 WHOOP_PASSWORD
4. 运行服务：
5. 对于 MCP 服务器： bash python src/whoop_server.py
6. 对于 HTTP API 服务器： bash ./run_whoop_server.sh

调试方式

1. 检查日志输出
2. 使用 check_auth_status() 检查认证状态
3. 确保日期格式正确
4. 检查网络连接

示例查询

• "What's my recovery score for today?"
• "Show me my strain data for the past week"
• "What's my average strain over the last 7 days?"
• "Get my latest cycle data"

许可证

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