Ctvidic Whoop MCP Server

🚀 Whoop MCP 服務器

Whoop MCP 服務器是一個基於 Python 的工具，它遵循 MIT 許可證，適用於 Python 3.12。此服務器藉助模型上下文協議 (MCP) 提供對 Whoop API 的訪問，讓語言模型能夠輕鬆查詢週期、恢復、壓力和鍛鍊等相關數據。

🚀 快速開始

使用此服務器需要 Whoop 憑據，服務器採用電子郵件/密碼進行身份驗證，通過 Whoop API 登錄。

Claude for Desktop

你需要更新 claude_desktop_config.json 文件。在 macOS 系統中，該文件位於 ~/Library/Application\ Support/Claude/claude_desktop_config.json；在 Windows 系統中，位於 %APPDATA%/Claude/claude_desktop_config.json。更新內容如下：

{
    "mcpServers": {
        "Whoop": {
            "command": "python",
            "args": ["/path/to/whoop/src/whoop_server.py"],
            "cwd": "/path/to/whoop",
            "env": {
                "WHOOP_EMAIL": "your.email@example.com",
                "WHOOP_PASSWORD": "your_password"
            }
        }
    }
}

HTTP API 服務器

項目包含的 HTTP API 服務器，將相同功能以 HTTP 端點形式公開。運行命令如下：

./run_whoop_server.sh

✨ 主要特性

該服務器公開了一系列實用工具，具體如下：

週期查詢

• get_cycle_collection(start_date: str, end_date: str)：獲取指定日期範圍（日期需為 ISO 格式，即 YYYY - MM - DD）的週期數據。
• get_latest_cycle()：獲取最新的週期數據。

恢復與壓力

• get_recovery_data(start_date: str, end_date: str)：獲取指定日期範圍的恢復數據。
• get_strain_data(start_date: str, end_date: str)：獲取指定日期範圍的壓力數據。
• get_average_strain(days: int = 7)：計算指定天數內的平均壓力。

資料與認證

• get_profile()：獲取用戶資料信息。
• check_auth_status()：檢查與 Whoop API 的認證狀態。

💻 使用示例

基礎用法

連接服務器後，你可以向 Claude 提出如下問題：

- “今天的恢復分數是多少？”
- “顯示過去一週的壓力數據”
- “過去7天內的平均壓力是多少？”
- “獲取最新的週期數據”

📚 詳細文檔

錯誤處理

該服務器能針對常見問題提供人類可讀的錯誤信息，涵蓋以下方面：

• 無效日期格式
• API 認證錯誤
• 網絡連接問題
• 缺少或無效憑證

項目結構

whoop/
├── src/
│   ├── whoop_server.py      # MCP 服務器實現
│   └── whoop_http_server.py # HTTP API 服務器實現
├── config/
│   └── .env                 # 環境變量
├── requirements.txt         # Python 依賴項
└── run_whoop_server.sh     # 運行服務器的腳本

📄 許可證

該項目採用 MIT License，具體信息請參閱 LICENSE 文件。