Whoop MCP Server

Whoop MCP サーバー

Python パッケージ ライセンス: MIT Python 3.12

Whoop API へのアクセスを提供する Model Context Protocol (MCP) サーバーです。言語モデルが Whoop API からサイクル、リカバリー、負荷（ストレイン）、ワークアウトのデータをクエリできるようにします。

利用可能なツール

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

サイクルのクエリ

• 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": "[email protected]",
                "WHOOP_PASSWORD": "your_password"
            }
        }
    }
}

HTTP API サーバー

このプロジェクトには、同じ機能を HTTP エンドポイント経由で公開する HTTP API サーバーも含まれています。実行するには次のようにします。

./run_whoop_server.sh

クエリの例

接続すると、Claude に次のような質問ができます。

• 「今日のリカバリースコアは？」
• 「過去 1 週間の負荷（ストレイン）データを見せて」
• 「過去 7 日間の平均負荷（ストレイン）は？」
• 「最新のサイクルデータを取得して」

エラー処理

このサーバーは、よくある問題に対して人間が読めるエラーメッセージを提供します。

• 日付形式が無効
• API 認証エラー
• ネットワーク接続の問題
• 認証情報の欠落または無効

プロジェクト構成

whoop/
├── src/
│   ├── whoop_server.py      # MCP server implementation
│   └── whoop_http_server.py # HTTP API server implementation
├── config/
│   └── .env                 # Environment variables
├── requirements.txt         # Python dependencies
└── run_whoop_server.sh     # Script to run HTTP server

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。