Whoop MCP Server

Whoop MCP 服务

Python 包许可证：MIT Python 3.12

一个提供 Whoop API 访问的 Model Context Protocol (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）。

用法

你需要 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": "[email protected]",
                "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

许可证

本项目依据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。