Whoop

🚀 Whoop MCP サーバー

このサーバーは、Model Context Protocol (MCP) を用いて Whoop API へのアクセスを提供します。言語モデルが周期、回復、ストレス、トレーニングデータを照会できるようにします。Python パッケージのライセンスは MIT で、Python 3.12 を使用しています。

✨ 主な機能

このサーバーは以下のツールを公開しています。

周期照会

• 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 の資格情報が必要です。サーバーは電子メール/パスワード認証を使用して 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 に以下のような質問をすることができます。

• "今日の回復スコアは何ですか？"
• "過去 1 週間のストレスデータを表示してください"
• "過去 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 ファイルを参照してください。