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