Whoop MCP 服务器

Python 包许可证：MIT Python 3.12

提供 Whoop API 访问权限的模型上下文协议 (MCP) 服务器。它允许语言模型通过 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)。

Related MCP server: Strava MCP Server

用法

您需要 Whoop 凭证才能使用此服务器。该服务器使用 Whoop API 进行电子邮件/密码身份验证。

克劳德桌面版

更新您的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 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