使用说明
WHOOP MCP服务器
用于WHOOP API的MCP(机器会话协议)服务器实现。
概述
该项目提供了一个与WHOOP API接口的服务器,允许您与您的WHOOP健身数据进行交互。它遵循MCP架构模式,实现了与AI助手的互操作性。
特性
- 访问WHOOP用户资料数据
- 检索睡眠数据和分析
- 获取锻炼信息
- 获取恢复指标
- 查看循环数据
先决条件
- Node.js(v16+)
- 具有API访问权限的WHOOP帐户
- WHOOP API密钥(从 WHOOP开发者门户)
安装
-
克隆此存储库:
git clone https://github.com/RyanLisse/whoop-mcp-server.git cd whoop-mcp-server -
安装依赖项:
npm install -
创建一个
.env文件基于.env.example模板:cp .env.example .env -
编辑
.env文件并添加您的WHOOP API密钥和其他配置选项。
用法
启动服务器
npm start
对于自动重启的开发:
npm run dev
服务器将在您的 .env 文件(默认值:3000)。
API终点
所有API端点都需要使用您的WHOOP API密钥进行身份验证。
用户档案
GET /whoop/profile-获取用户配置文件信息
睡眠数据
GET /whoop/sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD-获取指定日期范围内的睡眠数据
锻炼数据
GET /whoop/workouts?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD-获取指定日期范围内的锻炼数据
恢复数据
GET /whoop/recovery?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD-获取指定日期范围的恢复数据
周期数据
GET /whoop/cycles?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD-获取指定日期范围的周期数据
认证
将您的WHOOP API令牌添加到请求中的授权标头:
Authorization: Bearer YOUR_WHOOP_API_TOKEN
许可证
麻省理工学院
贡献
欢迎投稿!请随时提交拉取请求。