🚀 Whoop MCP 服务器
这是一个基于 Model Context Protocol (MCP) 的服务器，可提供对 Whoop API 的访问。借助它，语言模型能够轻松查询周期、恢复、压力和锻炼等相关数据。该 Python 包遵循 MIT 许可协议，支持 Python 3.12 版本。
🚀 快速开始
您需要 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 服务器，通过相同的端点公开相同的功能。要运行它：
./run_whoop_server.sh
✨ 主要特性
- 丰富的工具接口：提供了多种工具用于查询周期、恢复、压力等数据。
- 多方式使用：既可以在 Claude for Desktop 上使用，也可以通过 HTTP API 服务器使用。
- 良好的错误处理：为常见问题提供人类可读的错误消息。
📦 安装指南
文档未提及具体安装步骤，可参考项目中的 requirements.txt 文件安装 Python 依赖项。
💻 使用示例
基础用法
连接后，您可以询问 Claude 如下问题：
- "今天的恢复分数是多少？"
- "显示我过去一周的压力数据"
- "过去 7 天的平均压力是多少？"
- "获取我的最新周期数据"
📚 详细文档
可用工具
该服务器公开了以下工具：
周期查询
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/
├── src/
│ ├── whoop_server.py # MCP 服务器实现
│ └── whoop_http_server.py # HTTP API 服务器实现
├── config/
│ └── .env # 环境变量
├── requirements.txt # Python 依赖项
└── run_whoop_server.sh # 运行服务器的脚本
📄 许可证
该项目在 MIT 许可证下分发——请参阅 LICENSE 文件以获取详细信息。