Whoop MCP 服务器

Python 包许可证：MIT Python 3.12

一个模型上下文协议 (MCP) 服务器，提供对 Whoop API 的访问。它允许语言模型查询来自 Whoop API 的周期、恢复、劳损和锻炼数据。

可用工具

该服务器公开了以下工具：

周期查询

• get_cycle_collection(start_date: str, end_date: str): 获取特定日期范围的周期数据
• 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 的身份验证状态

日期应以 ISO 格式 (YYYY-MM-DD) 提供。

用法

您需要 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

示例查询

连接后，您可以向 Claude 提出如下问题：

• "我今天的恢复分数是多少？"
• "显示我过去一周的劳损数据"
• "过去 7 天我的平均劳损是多少？"
• "获取我最新的周期数据"

错误处理

该服务器为常见问题提供人类可读的错误消息：

• 无效的日期格式
• API 身份验证错误
• 网络连接问题
• 缺少或无效的凭据

项目结构

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

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。