FindMCP Logo FindMCP.info
Whoop API MCP Server

Whoop API MCP Server

site icon
2025.03.16 0
健身服务健康数据管理其它
Whoop API MCP Server 是一个用于与 Whoop API 交互以获取健身和健康数据的 MCP（Mission Control Protocol）服务器。它提供了一个标准化的接口，用于通过 Whoop API 访问健身数据，处理认证、数据检索和格式化，以便轻松将 Whoop 数据集成到应用程序中。
View on GitHub

Overview

基本能力

产品定位

Whoop API MCP Server 是一个用于与 Whoop API 交互以获取健身和健康数据的 MCP（Mission Control Protocol）服务器。

核心功能

  • OAuth 2.0 认证与 Whoop API
  • 用户个人信息
  • 恢复数据
  • 睡眠数据
  • 锻炼数据
  • 月经周期跟踪数据
  • MCP 兼容的发现端点
  • 清晰的错误处理和日志记录

适用场景

  • 健身应用集成
  • 健康数据分析
  • 个人健康管理

工具列表

  • GET /user - 获取用户个人信息
  • GET /user/membership - 获取用户会员信息
  • GET /recovery?start=YYYY-MM-DD&end=YYYY-MM-DD - 获取指定日期范围内的恢复数据
  • GET /recovery/latest - 获取最新的恢复数据
  • GET /sleep?start=YYYY-MM-DD&end=YYYY-MM-DD - 获取指定日期范围内的睡眠数据
  • GET /workout?start=YYYY-MM-DD&end=YYYY-MM-DD - 获取指定日期范围内的锻炼数据
  • GET /cycle?start=YYYY-MM-DD&end=YYYY-MM-DD - 获取指定日期范围内的月经周期数据

常见问题解答

  • 如何获取 Whoop API 凭证？ 需要在 Whoop 开发者门户注册应用并获取凭证。
  • 如何启动服务器？ 使用 npm start 命令启动服务器。
  • 如何认证用户？ 将用户引导至 http://localhost:3000/auth/login 进行认证。

使用教程

使用依赖

  • Node.js 16.x 或更高版本
  • Whoop 开发者账户和 API 凭证
  • 在 Whoop 开发者门户注册应用

安装教程

  1. 克隆仓库： git clone https://github.com/RyanLisse/whoop-api-mcp.git cd whoop-api-mcp

  2. 安装依赖： npm install

  3. 创建 .env 文件： cp .env.example .env

  4. 更新 .env 文件： WHOOP_CLIENT_ID=your_client_id_here WHOOP_CLIENT_SECRET=your_client_secret_here WHOOP_REDIRECT_URI=http://localhost:3000/auth/callback

调试方式

  1. 启动服务器： npm start

  2. 访问 MCP 端点： http://localhost:3000/.well-known/mcp.json

  3. 认证用户： http://localhost:3000/auth/login

  4. 使用 API 端点获取数据。

许可证

该项目遵循 MIT 开源许可条款。