Whoop MCP Server

🚀 WHOOP MCP 服務器

本項目是一個實現 WHOOP API 的 MCP（機器對話協議）服務器，可與 WHOOP API 對接，讓您輕鬆訪問 WHOOP 健身數據，還遵循 MCP 架構模式，實現人工智能助手的互操作。

🚀 快速開始

該項目提供了一個與 WHOOP API 對接的服務器，允許您訪問 WHOOP 健身數據。它遵循 MCP 架構模式，使人工智能助手能夠互操作。

✨ 主要特性

• 訪問 WHOOP 用戶個人資料數據
• 獲取睡眠數據和分析
• 檢索鍛鍊信息
• 查看恢復指標
• 瀏覽週期數據

📦 安裝指南

先決條件

• Node.js（v16+）
• 帶有 API 訪問權限的 WHOOP 賬戶
• 從 WHOOP 開發者門戶獲得的 WHOOP API 密鑰

安裝步驟

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。