Intervals.icu MCP Server & KI-Laufcoach

Ein offizieller Model Context Protocol (MCP) Server und KI-Laufcoach-Intelligenzsystem für Intervals.icu.

Befähigen Sie Ihre KI-Assistenten (Claude Desktop, Antigravity, Cursor, VS Code Cline / Roo-Code), Echtzeit-Telemetrie zu lesen, akute und chronische Trainingsbelastung (CTL/ATL/TSB/ACWR) zu bewerten, Jack Daniels VDOT & Tempobereiche zu berechnen, Herzfrequenzdrift & aerobe Entkopplung zu berechnen, Wettkampfzeiten vorherzusagen, Tapering zu planen und strukturierte Workouts direkt in Ihren Intervals.icu-Kalender zu veröffentlichen.

📑 Inhaltsverzeichnis

• ✨ Hauptfunktionen

• 🚀 3-Minuten-Schnellstart

• ⚙️ Konfiguration (API-Schlüssel & Athleten-ID)

• 🔌 MCP-Client-Einrichtungsanleitungen

  • Claude Desktop

  • Antigravity

  • Cursor

  • VS Code (Cline / Roo-Code)

• 🤖 KI-Workflows & Slash-Commands-Verzeichnis

• 👤 Anpassen Ihres Athletenprofils

• 💬 Beispiel-Chat-Prompts

• 🛠️ Vollständige MCP-Tools-Referenz

• 🧪 Entwicklung & Tests

• 📄 Lizenz

Related MCP server: Intervals.icu MCP Server

✨ Hauptfunktionen

• 🏃 Echtzeit-Telemetrie & Stream-Erfassung: Extrahieren Sie Watt, Herzfrequenz, Trittfrequenz, Geschwindigkeit und Intervall-Splits aus abgeschlossenen Einheiten.

• ⚡ Aerobe Entkopplung & Herzfrequenzdrift-Engine: Berechnen Sie den Effizienzfaktor (EF) $H_1$ vs. $H_2$, um kardiovaskuläre Drift (>5%) oder Dehydrierung zu erkennen.

• 🩹 Einheitliches Erholungs- & Bereitschafts-Scoring: 0–100% zusammengesetzter Score, der TSB, ACWR, Schlaf-Score, HRV und RHR-Spike zu Grün/Gelb/Rot-Aktionssignalen kombiniert.

• 🏆 Wettkampfzeit-Vorhersage & Tapering-Planer: Jack Daniels VDOT-Formel + CTL-Fitness- und TSB-Frische-Anpassungen + Generator für 2–3-wöchige Volumenreduktion.

• ⚖️ ACWR & wöchentliche Belastungsbudgetierung: Sichere Volumenprogression-Obergrenzen (Langer Lauf 30–35%, Qualität 15–20%, locker 45–55%) basierend auf 42-Tage-Rolling-Baseline.

• 📅 Strukturierter Workout-Builder: Veröffentlichen Sie Workouts im Intervals.icu-Kalender mit nativer Intervals-Text-DSL (Warmup, Main Set Nx, Cooldown).

🚀 3-Minuten-Schnellstart

1. Voraussetzungen

• Node.js: >= 18.0.0

• Paketmanager: pnpm (empfohlen), npm oder yarn

• Intervals.icu-Konto & API-Schlüssel

2. Klonen & Erstellen

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

⚙️ Konfiguration

Rufen Sie Ihre Anmeldedaten von Intervals.icu-Einstellungen ab:

1. Scrollen Sie nach unten zum Abschnitt Entwickler.

2. Kopieren Sie Ihren API-Schlüssel (z. B. your_api_key_here).

3. Notieren Sie Ihre Athleten-ID (in den Einstellungen oder der Profil-URL zu finden, z. B. i12345 oder verwenden Sie self).

Umgebungsvariablen

🔌 MCP-Client-Einrichtungsanleitungen

1. Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

• 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

In Ihren Antigravity-MCP-Einstellungen oder .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

In Cursor-Einstellungen > Funktionen > MCP-Server oder .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)

In 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": []
    }
  }
}

🤖 KI-Workflows & Slash-Commands-Verzeichnis

Dieses Repository enthält 11 produktionsreife KI-Workflows in .agents/workflows/, die Sie über Slash-Commands auslösen können:

👤 Anpassen Ihres Athletenprofils

Um Ihrem KI-Assistenten genauen Coaching-Kontext zu geben, konfigurieren Sie Ihr Profil in .agents/skills/running-coach-analysis/SKILL.md:

1. Abschnitt 2 (Athletenprofil): Füllen Sie Name, Alter, Fallback-Gewicht und Zielwettkampfziele aus.

2. Abschnitt 3 (Physiologische Basis): Geben Sie Fallback-CP/FTP, LTHR, Max-HF und Ruhe-HF an (Hinweis: aktive Werte werden automatisch dynamisch über MCP synchronisiert).

3. Abschnitt 4 (Wochenstruktur & Baupläne): Definieren Sie Ihre wöchentliche Trainingsfrequenz, bevorzugte Trainingseinheiten (z. B. Subthreshold, VO2Max, Langer Lauf) und spezifische Leistungs-/Tempoziele.

💬 Beispiel-Chat-Prompts

Hier sind Beispiele, wie Sie mit Ihrem KI-Laufcoach chatten können:

1. Tägliche Bewertung nach dem Lauf

"Hier ist mein Workout von heute Morgen. Bitte führen Sie /run-report auf meiner letzten Aktivität aus. RPE war 6/10, die Beine fühlten sich beim 3. Intervall federnd an."

2. Bereitschaftscheck vor dem Training

"/readiness-check — Bin ich für die heutige Subthreshold-Intervall-Einheit gut erholt, oder sollte ich die Intensität auf Zone 2 begrenzen?"

3. Wöchentliche Volumenverteilung

"/weekly-budget distance — Was ist meine empfohlene Gesamtkilometerzahl und die Obergrenze für den langen Lauf diese Woche?"

4. Wettkampftag-Vorhersage & Tapering

"/predict-race — Mein aktives VDOT ist 50 und mein Ziel-Halbmarathon ist am 2026-10-15. Geben Sie mir eine Zielzeitvorhersage und einen 2-wöchigen Tapering-Plan."

5. Workout im Kalender planen

"/create-workout — Planen Sie eine 50-minütige Subthreshold-Einheit (Warmup 12m, 6x3m @ 95-98% CP mit 1m Pause, Cooldown 6m) für morgen."

🛠️ Vollständige MCP-Tools-Referenz

Der Server stellt 20+ Tools bereit, gruppiert nach Kategorie:

🏃 1. Aktivitäten & Streams

• get_activities: Aktivitäten innerhalb eines Datumsbereichs abrufen (oldest, newest, type).

• get_activity_details: Vollständige Telemetrie, Metriken und physiologische Athletenwerte für eine Aktivitäts-ID abrufen.

• get_activity_intervals: Runden- und Arbeits-/Ruhe-Intervall-Aufschlüsselungen extrahieren.

• get_activity_streams: Zugriff auf rohe Zeitreihen-Stream-Daten (watts, heartrate, cadence, velocity_smooth, altitude).

• get_activity_messages: Aktivitätskommentare und Notizen lesen.

• add_activity_message: Coaching-Feedback zu einer Aktivität posten.

👤 2. Athleten-Biometrie & Zonen

• get_athlete_profile: Athletenprofil abrufen (FTP, LTHR, Max-HF, Gewicht, Ruhe-HF).

• get_training_zones: Zugriff auf Leistungs-, Herzfrequenz- und Tempo-Trainingszonengrenzen.

🧮 3. Physiologie & Ausdauer-Intelligenz (Offline)

• calculate_vdot: Jack Daniels VDOT & VO₂max aus Renn-/Tempo-Zeitfahren berechnen.

• calculate_pace_zones: 5 Tempo-Trainingszonen (Locker, Marathon, Schwelle, Intervall, Wiederholung) in MM:SS/km berechnen.

• predict_race_time: Wettkampfzielzeit und -tempo (5K, 10K, HM, FM oder benutzerdefinierte km) aus VDOT mit CTL-Fitness- und TSB-Frische-Anpassungen vorhersagen.

• calculate_taper_plan: Wöchentlichen Volumenreduktionsplan (75% → 50% → 30%) für maximale TSB-Frische am Wettkampftag generieren.

• analyze_cardiac_drift: Effizienzfaktor (EF) und aerobe Entkopplung % aus rohen Telemetrie-Streams (heartrateStream, powerOrSpeedStream) berechnen.

• calculate_readiness_score: Einheitlichen Erholungsscore (0–100%, Grün/Gelb/Rot) berechnen, der TSB, ACWR, Schlaf, HRV und RHR kombiniert.

⚖️ 4. Trainingsbelastung & Periodisierung (Offline)

• analyze_training_load: ACWR (ATL/CTL) berechnen, TSB-Bereitschaftszonen klassifizieren und Rampenraten-Verletzungsrisiko bewerten.

• calculate_weekly_budget: Sicheres wöchentliches Trainingsbudget berechnen (Gesamtvolumen, Langer Lauf 30–35%, Qualität 15–20%, locker 45–55%) basierend auf 42-Tage-Rolling-Durchschnitt.

📅 5. Kalender & Workout-Builder

• get_events: Kalendereinträge (geplante Workouts, Notizen, Rennen) im Datumsbereich abrufen.

• get_event_by_id: Detaillierte Ereignisdaten per ID abrufen.

• create_running_workout: Strukturierter Workout-Builder — Strukturierte Workouts validieren und mit Text-DSL im Intervals.icu-Kalender veröffentlichen.

• add_or_update_planned_workout: Geplante Workout-Ereignisse erstellen oder aktualisieren.

• add_or_update_note: Textnotizen zu Kalenderdaten hinzufügen.

• delete_event: Kalenderereignisse per ID entfernen.

• get_workout_library: Workout-Vorlagenbibliothek durchsuchen.

• get_workout_by_id: Workout-Vorlagendetails abrufen.

🚴 6. Ausrüstung & Leistungskurven

• get_gear_list: Registrierte Fahrräder, Schuhe und Ausrüstung mit Kilometerstand auflisten (30 Min. gecacht).

• get_athlete_power_curves: Leistungsdauerkurven abrufen (60 Min. gecacht).

💚 7. Wellness- & Fitness-Zeitreihen

• get_wellness_data: Tägliche Wellness-Einträge abrufen (Schlaf-Score, HRV, Ruhepuls, Müdigkeit, Muskelkater, Gewicht).

• get_fitness_chart: Zeitreihen-Fitnessdaten abrufen (ctl, atl, tsb, rampRate, eftp).

🧪 Entwicklung & Testen

Führen Sie die vollständige Unit-Test-Suite aus:

# Run Vitest unit tests
pnpm test

# Build TypeScript
pnpm run build

# Watch mode during development
pnpm exec vitest

Enthält 59+ Unit-Tests, die API-Client-Auto-Retry bei HTTP 429, LRU-TTL-Caching, Jack-Daniels-VDOT-Mathematik, Rennvorhersage, Herzfrequenz-Drift-Analyse, Erholungsbewertung, ACWR-Analysen und Workout-DSL-Validierung abdecken.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz © Muhammad Hadid Wiransetyo lizenziert.