WHOOP MCP Server

WHOOP MCP 服务

WHOOP API 的 MCP（Machine Conversation Protocol）服务实现。

概述

本项目提供了一个与 WHOOP API 交互的服务，让你能够使用 WHOOP 健身数据。它遵循 MCP 架构模式，可实现与 AI 助手的互操作性。

功能

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

先决条件

• Node.js（v16+）
• 具备 API 访问权限的 WHOOP 账户
• WHOOP API 密钥（从 WHOOP Developer Portal 获取）

安装

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 - 获取指定日期范围内的周期数据

身份验证

在请求的 Authorization 标头中添加 WHOOP API 令牌：

Authorization: Bearer YOUR_WHOOP_API_TOKEN

许可证

MIT

贡献

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