Ctvidic Whoop MCP Server

🚀 Whoop MCP サーバー

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

Whoop API へのアクセスを提供するモデルコンテキストプロトコル (MCP) サーバーです。言語モデルが周期、回復、ストレス、トレーニングデータを照会できるようにします。

✨ 主な機能

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

周期照会

• 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 エンドポイントとして公開する 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 ファイルを参照してください。