WHOOP MCP 服务器

一个用于 WHOOP API 的 MCP (机器会话协议) 服务器实现。

概述

本项目提供了一个与 WHOOP API 交互的服务器，允许您与您的 WHOOP 健身数据进行交互。它遵循 MCP 架构模式，该模式支持与 AI 助手的互操作性。

功能

• 访问 WHOOP 用户个人资料数据
• 检索睡眠数据和分析
• 获取锻炼信息
• 获取恢复指标
• 查看周期数据

前提条件

• Node.js (v16+)
• 具有 API 访问权限的 WHOOP 帐户
• WHOOP API 密钥 (从 WHOOP 开发者门户 获取)

安装

1. 克隆此存储库：

   git clone https://github.com/RyanLisse/whoop-mcp-server.git
   cd whoop-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 基于 .env.example 模板创建一个 .env 文件：

   cp .env.example .env
   

4. 编辑 .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 标头中：

Authorization: Bearer YOUR_WHOOP_API_TOKEN

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。