Whoop MCP サーバー

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

Whoop APIへのアクセスを提供するモデルコンテキストプロトコル（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) で指定する必要があります。

Related MCP server: Strava MCP Server

使用法

このサーバーを使用するにはWhoopの認証情報が必要です。サーバーはWhoop APIを使用してメールアドレスとパスワードによる認証を行います。

デスクトップ版クロード

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エンドポイント経由で同じ機能を公開するHTTP APIサーバーも含まれています。実行するには、以下の手順に従ってください。

./run_whoop_server.sh

クエリの例

接続すると、次のような質問をクロードに尋ねることができます。

「今日の回復スコアは？」
「過去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