WHOOP MCP Server

WHOOP MCP サーバー

WHOOP API 用の MCP（Machine Conversation Protocol）サーバー実装です。

概要

このプロジェクトでは、WHOOP API と連携するサーバーを提供し、WHOOP のフィットネスデータを操作できます。AI アシスタントとの相互運用を可能にする MCP アーキテクチャパターンに従っています。

機能

• WHOOP ユーザープロフィールデータへのアクセス
• 睡眠データと分析情報の取得
• ワークアウト情報の取得
• リカバリ指標の取得
• サイクルデータの表示

前提条件

• Node.js（v16+）
• API にアクセスできる WHOOP アカウント
• WHOOP API キー（WHOOP Developer Portalから取得）

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/RyanLisse/whoop-mcp-server.git
   cd whoop-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. .env.example テンプレートを基に .env ファイルを作成します：

   cp .env.example .env
   

4. .env ファイルを編集し、WHOOP API キーとその他の設定オプションを追加します。

使い方

サーバーの起動

npm start

自動再起動を有効にして開発する場合：

npm run dev

サーバーは .env ファイルで指定したポート（デフォルト：3000）で起動します。

API エンドポイント

すべての API エンドポイントでは、WHOOP API キーによる認証が必要です。

ユーザープロフィール

• GET /whoop/profile - ユーザープロフィール情報を取得します

睡眠データ

• GET /whoop/sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD - 指定した期間の睡眠データを取得します

ワークアウトデータ

• GET /whoop/workouts?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD - 指定した期間のワークアウトデータを取得します

リカバリデータ

• GET /whoop/recovery?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD - 指定した期間のリカバリデータを取得します

サイクルデータ

• GET /whoop/cycles?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD - 指定した期間のサイクルデータを取得します

認証

リクエストの Authorization ヘッダーに WHOOP API トークンを追加します：

Authorization: Bearer YOUR_WHOOP_API_TOKEN

ライセンス

MIT

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。