Whoop

🚀 Whoop MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，可提供對 Whoop API 的訪問。藉助它，語言模型能夠輕鬆查詢週期、恢復、壓力和鍛鍊等相關數據。該 Python 包遵循 MIT 許可協議，支持 Python 3.12 版本。

🚀 快速開始

您需要 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 服務器，通過相同的端點公開相同的功能。要運行它：

./run_whoop_server.sh

✨ 主要特性

• 豐富的工具接口：提供了多種工具用於查詢週期、恢復、壓力等數據。
• 多方式使用：既可以在 Claude for Desktop 上使用，也可以通過 HTTP API 服務器使用。
• 良好的錯誤處理：為常見問題提供人類可讀的錯誤消息。

📦 安裝指南

文檔未提及具體安裝步驟，可參考項目中的 requirements.txt 文件安裝 Python 依賴項。

💻 使用示例

基礎用法

連接後，您可以詢問 Claude 如下問題：

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

📚 詳細文檔

可用工具

該服務器公開了以下工具：

週期查詢

• get_cycle_collection(start_date: str, end_date: str)：獲取特定日期範圍內的週期數據
• 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 的身份驗證狀態

日期應以 ISO 格式（YYYY-MM-DD）提供。

🔧 技術細節

項目結構

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

📄 許可證

該項目在 MIT 許可證下分發——請參閱 LICENSE 文件以獲取詳細信息。