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

更新你的’claude_desktop_config。

Whoop MCP Server

Python Package License: MIT Python 3.12

A Model Context Protocol (MCP) server that provides access to the Whoop API. It allows language models to query cycles, recovery, strain, and workout data from the Whoop API.

Available Tools

The server exposes the following tools:

Cycle Queries

• get_cycle_collection(start_date: str, end_date: str): Get cycle data for a specific date range
• get_latest_cycle(): Get the most recent cycle data

Recovery and Strain

• get_recovery_data(start_date: str, end_date: str): Get recovery data for a specific date range
• get_strain_data(start_date: str, end_date: str): Get strain data for a specific date range
• get_average_strain(days: int = 7): Calculate average strain over specified number of days

Profile and Authentication

• get_profile(): Get user profile information
• check_auth_status(): Check authentication status with Whoop API

Dates should be provided in ISO format (YYYY-MM-DD).

Usage

You’ll need Whoop credentials to use this server. The server uses email/password authentication with the Whoop API.

Claude for Desktop

Update your claude_desktop_config.json (located in ~/Library/Application\ Support/Claude/claude_desktop_config.json on macOS and %APPDATA%/Claude/claude_desktop_config.json on Windows) to include the following:

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

HTTP API Server

The project also includes an HTTP API server that exposes the same functionality over HTTP endpoints. To run it:

./run_whoop_server.sh

Example Queries

Once connected, you can ask Claude questions like:

• “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”

Error Handling

The server provides human-readable error messages for common issues:

• Invalid date formats
• API authentication errors
• Network connectivity problems
• Missing or invalid credentials

Project Structure

whoop/
├── src/
│   ├── whoop_server.py      # MCP server implementation
│   └── whoop_http_server.py # HTTP API server implementation
├── config/
│   └── .env                 # Environment variables
├── requirements.txt         # Python dependencies
└── run_whoop_server.sh     # Script to run HTTP server

License

This project is licensed under the MIT License - see the LICENSE file for details.