🚀 Whoop MCP 服务器

Whoop MCP 服务器是一个基于 Python 的工具，它遵循 MIT 许可证，适用于 Python 3.12。此服务器借助模型上下文协议 (MCP) 提供对 Whoop API 的访问，让语言模型能够轻松查询周期、恢复、压力和锻炼等相关数据。

🚀 快速开始

使用此服务器需要 Whoop 凭据，服务器采用电子邮件/密码进行身份验证，通过 Whoop API 登录。

Claude for Desktop

你需要更新 claude_desktop_config.json 文件。在 macOS 系统中，该文件位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json；在 Windows 系统中，位于 %APPDATA%/Claude/claude_desktop_config.json。更新内容如下：

{
    "mcpServers": {
        "Whoop": {
            "command": "python",
            "args": ["/path/to/whoop/src/whoop_server.py"],
            "cwd": "/path/to/whoop",
            "env": {
                "WHOOP_EMAIL": "your.email@example.com",
                "WHOOP_PASSWORD": "your_password"
            }
        }
    }
}

HTTP API 服务器

项目包含的 HTTP API 服务器，将相同功能以 HTTP 端点形式公开。运行命令如下：

./run_whoop_server.sh

✨ 主要特性

该服务器公开了一系列实用工具，具体如下：

周期查询

• get_cycle_collection(start_date: str, end_date: str)：获取指定日期范围（日期需为 ISO 格式，即 YYYY - MM - DD）的周期数据。
• get_latest_cycle()：获取最新的周期数据。

恢复与压力

• get_recovery_data(start_date: str, end_date: str)：获取指定日期范围的恢复数据。
• get_strain_data(start_date: str, end_date: str)：获取指定日期范围的压力数据。
• get_average_strain(days: int = 7)：计算指定天数内的平均压力。

资料与认证

• get_profile()：获取用户资料信息。
• check_auth_status()：检查与 Whoop API 的认证状态。

💻 使用示例

基础用法

连接服务器后，你可以向 Claude 提出如下问题：

- “今天的恢复分数是多少？”
- “显示过去一周的压力数据”
- “过去7天内的平均压力是多少？”
- “获取最新的周期数据”

📚 详细文档

错误处理

该服务器能针对常见问题提供人类可读的错误信息，涵盖以下方面：

• 无效日期格式
• API 认证错误
• 网络连接问题
• 缺少或无效凭证

项目结构

whoop/
├── src/
│   ├── whoop_server.py      # MCP 服务器实现
│   └── whoop_http_server.py # HTTP API 服务器实现
├── config/
│   └── .env                 # 环境变量
├── requirements.txt         # Python 依赖项
└── run_whoop_server.sh     # 运行服务器的脚本

📄 许可证

该项目采用 MIT License，具体信息请参阅 LICENSE 文件。