Intervals.icu MCP サーバー & AI ランニングコーチ

Intervals.icu 向けのプロダクショングレードの Model Context Protocol (MCP) サーバーおよびAI ランニングコーチ知能システムです。

AI アシスタント（Claude Desktop、Antigravity、Cursor、VS Code Cline / Roo-Code）に、リアルタイムテレメトリの読み取り、急性・慢性トレーニング負荷（CTL/ATL/TSB/ACWR）の評価、Jack Daniels VDOT とペースゾーンの計算、心拍ドリフトと有酸素デカップリングの算出、レースタイムの予測、テーパリングのスケジューリング、そして構造化ワークアウトの Intervals.icu カレンダーへの直接公開を可能にします。

📑 目次

• ✨ 主な機能

• 🚀 3分クイックスタート

• ⚙️ 設定（APIキーとアスリートID）

• 🔌 MCP クライアント設定ガイド

  • Claude Desktop

  • Antigravity

  • Cursor

  • VS Code（Cline / Roo-Code）

• 🤖 AI ワークフロー & スラッシュコマンド一覧

• 👤 アスリートプロフィールのカスタマイズ

• 💬 チャットプロンプトの例

• 🛠️ MCP ツール完全リファレンス

• 🧪 開発とテスト

• 📄 ライセンス

Related MCP server: Intervals.icu MCP Server

✨ 主な機能

• 🏃 リアルタイムテレメトリとストリーム取り込み: 完了したセッションからワット数、心拍数、ケイデンス、速度、インターバルスプリットを抽出します。

• ⚡ 有酸素デカップリング & 心拍ドリフトエンジン: Efficiency Factor (EF) $H_1$ と $H_2$ を計算し、心血管ドリフト（>5%）や脱水を検出します。

• 🩹 統合リカバリー & レディネススコア: TSB、ACWR、睡眠スコア、HRV、RHR スパイクを組み合わせた 0〜100% の複合スコアを、Green/Yellow/Red のアクションシグナルとして算出します。

• 🏆 レースタイム予測 & テーパリングプランナー: Jack Daniels VDOT 計算式 + CTL フィットネスと TSB フレッシュネス調整 + 2〜3週間のボリューム削減ジェネレーター。

• ⚖️ ACWR & 週間負荷予算管理: 42日間のローリングベースラインに基づく安全なボリューム進行上限（ロングラン 30〜35%、クオリティ 15〜20%、イージー 45〜55%）。

• 📅 構造化ワークアウトビルダー: ネイティブの Intervals Text DSL（Warmup、Main Set Nx、Cooldown）を使用して、ワークアウトを Intervals.icu カレンダーに公開します。

🚀 3分クイックスタート

1. 前提条件

• Node.js: >= 18.0.0

• パッケージマネージャー: pnpm（推奨）、npm、または yarn

• Intervals.icu アカウントと API キー

2. クローンとビルド

git clone https://github.com/hadidwirsty/intervals-icu-mcp.git
cd intervals-icu-mcp
pnpm install
pnpm run build

⚙️ 設定

Intervals.icu 設定 から認証情報を取得します:

1. Developer セクションまでスクロールダウンします。

2. API キーをコピーします（例: your_api_key_here）。

3. アスリート ID を確認します（設定またはプロフィール URL に記載。例: i12345、または self を使用）。

環境変数

🔌 MCP クライアント設定ガイド

1. Claude Desktop

以下を claude_desktop_config.json に追加します:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "intervals-icu": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/intervals-icu-mcp/dist/index.js"],
      "env": {
        "INTERVALS_API_KEY": "YOUR_API_KEY_HERE",
        "INTERVALS_ATHLETE_ID": "self"
      }
    }
  }
}

2. Antigravity

Antigravity の MCP 設定または .gemini/config/mcp.json に追加します:

{
  "mcpServers": {
    "intervals-icu": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/intervals-icu-mcp/dist/index.js"],
      "env": {
        "INTERVALS_API_KEY": "YOUR_API_KEY_HERE",
        "INTERVALS_ATHLETE_ID": "self"
      }
    }
  }
}

3. Cursor

Cursor 設定 > 機能 > MCP サーバー、または .cursor/mcp.json に追加します:

{
  "mcpServers": {
    "intervals-icu": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/intervals-icu-mcp/dist/index.js"],
      "env": {
        "INTERVALS_API_KEY": "YOUR_API_KEY_HERE",
        "INTERVALS_ATHLETE_ID": "self"
      }
    }
  }
}

4. VS Code（Cline / Roo-Code）

cline_mcp_settings.json に追加します:

{
  "mcpServers": {
    "intervals-icu": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/intervals-icu-mcp/dist/index.js"],
      "env": {
        "INTERVALS_API_KEY": "YOUR_API_KEY_HERE",
        "INTERVALS_ATHLETE_ID": "self"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

🤖 AI ワークフロー & スラッシュコマンド一覧

このリポジトリには、.agents/workflows/ に本番運用可能な 11 の AI ワークフローがプリロードされており、スラッシュコマンドで起動できます:

👤 アスリートプロフィールのカスタマイズ

AI アシスタントに正確なコーチングコンテキストを提供するには、.agents/skills/running-coach-analysis/SKILL.md でプロフィールを設定します:

1. セクション 2（アスリートプロフィール）: 名前、年齢、フォールバック体重、目標レース目標を入力します。

2. セクション 3（生理学的ベースライン）: フォールバックの CP/FTP、LTHR、最大心拍数、安静時心拍数を入力します（注: アクティブな値は MCP を介して動的に自動同期されます）。

3. セクション 4（週間構成とブループリント）: 週間トレーニング頻度、好みのワークアウトセッション（例: サブスレッショルド、VO2Max、ロングラン）、および具体的なパワー/ペース目標を定義します。

💬 チャットプロンプトの例

AI ランニングコーチとのチャット方法の例を以下に示します:

1. 毎日のランニング後評価

"今朝のワークアウトです。最新のアクティビティで /run-report を実行してください。RPE は 6/10 で、3本目のインターバル中は脚が軽く感じられました。"

2. ワークアウト前のレディネスチェック

"/readiness-check — 今日のサブスレッショルドインターバルセッションに向けて十分に回復していますか、それとも強度をゾーン 2 に制限すべきですか？"

3. 週間ボリューム配分

"/weekly-budget distance — 今週の推奨総走行距離とロングランの上限はどれくらいですか？"

4. レースデー予測とテーパリング

"/predict-race — 現在の VDOT は 50 で、目標のハーフマラソンレースは 2026-10-15 です。完走タイム予測と 2 週間のテーパリングスケジュールを教えてください。"

5. カレンダーへのワークアウトスケジュール

"/create-workout — 明日、50 分のサブスレッショルドセッション（ウォームアップ 12 分、6x3 分 @ CP の 95〜98%、レスト 1 分、クールダウン 6 分）をスケジュールしてください。"

🛠️ MCP ツール完全リファレンス

サーバーはカテゴリ別に 20 以上のツールを公開しています:

🏃 1. アクティビティ & ストリーム

• get_activities: 日付範囲内のアクティビティを取得します（oldest、newest、type）。

• get_activity_details: アクティビティ ID の完全なテレメトリ、メトリクス、アスリートの生理学的値を取得します。

• get_activity_intervals: ラップとワーク/レストのインターバル内訳を抽出します。

• get_activity_streams: 生の時系列ストリームデータ（watts、heartrate、cadence、velocity_smooth、altitude）にアクセスします。

• get_activity_messages: アクティビティのコメントとメモを読み取ります。

• add_activity_message: アクティビティにコーチングフィードバックを投稿します。

👤 2. アスリートの生体情報 & ゾーン

• get_athlete_profile: アスリートプロフィール（FTP、LTHR、最大心拍数、体重、安静時心拍数）を取得します。

• get_training_zones: パワー、心拍数、ペーストレーニングゾーンの境界にアクセスします。

🧮 3. 生理学 & 持久力インテリジェンス（オフライン）

• calculate_vdot: レース/テンポタイムトライアルから Jack Daniels VDOT と VO₂max を計算します。

• calculate_pace_zones: 5 つのペーストレーニングゾーン（イージー、マラソン、閾値、インターバル、レペティション）を MM:SS/km で計算します。

• predict_race_time: VDOT からレース完走タイムとペース（5K、10K、HM、FM、またはカスタム km）を、CTL フィットネスと TSB フレッシュネス調整付きで予測します。

• calculate_taper_plan: レースデーのピーク TSB フレッシュネスに向けた週間ボリューム削減スケジュール（75% → 50% → 30%）を生成します。

• analyze_cardiac_drift: 生のテレメトリストリーム（heartrateStream、powerOrSpeedStream）から Efficiency Factor (EF) と有酸素デカップリング % を計算します。

• calculate_readiness_score: TSB、ACWR、睡眠、HRV、RHR を組み合わせた統合リカバリースコア（0〜100%、Green/Yellow/Red）を計算します。

⚖️ 4. トレーニング負荷 & ピリオダイゼーション（オフライン）

• analyze_training_load: ACWR（ATL/CTL）を計算し、TSB レディネスゾーンを分類し、ランプレートの怪我リスクを評価します。

• calculate_weekly_budget: 42 日間のローリング平均に基づく安全な週間トレーニング予算（総ボリューム、ロングラン 30〜35%、クオリティ 15〜20%、イージー 45〜55%）を計算します。

📅 5. カレンダー & ワークアウトビルダー

• get_events: 日付範囲内のカレンダー項目（予定ワークアウト、メモ、レース）を取得します。

• get_event_by_id: ID で詳細なイベントデータを取得します。

• create_running_workout: 構造化ワークアウトビルダー — Text DSL を使用して構造化ワークアウトを検証し、Intervals.icu カレンダーに公開します。

• add_or_update_planned_workout: 予定ワークアウトイベントを作成または更新します。

• add_or_update_note: カレンダーの日付にテキストメモを追加します。

• delete_event: ID でカレンダーイベントを削除します。

• get_workout_library: ワークアウトテンプレートライブラリを検索します。

• get_workout_by_id: ワークアウトテンプレートの詳細を取得します。

🚴 6. ギア & パワーカーブ

• get_gear_list: 登録済みのバイク、シューズ、装備を走行距離付きで一覧表示します（30 分キャッシュ）。

• get_athlete_power_curves: パワーデュレーションカーブを取得します（60 分キャッシュ）。

💚 7. ウェルネス & フィットネス時系列

• get_wellness_data: 毎日のウェルネス記録（睡眠スコア、HRV、安静時心拍数、疲労度、筋肉痛、体重）を取得します。

• get_fitness_chart: 時系列フィットネスデータ（ctl、atl、tsb、rampRate、eftp）を取得します。

🧪 開発とテスト

完全なユニットテストスイートを実行します：

# Run Vitest unit tests
pnpm test

# Build TypeScript
pnpm run build

# Watch mode during development
pnpm exec vitest

59以上のユニットテストが含まれており、HTTP 429でのAPIクライアントの自動リトライ、LRU TTLキャッシュ、Jack Daniels VDOT計算、レース予測、心拍ドリフト分析、回復スコアリング、ACWR分析、ワークアウトDSL検証をカバーしています。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。© Muhammad Hadid Wiransetyo.