Strava MCP-Server

Ein Model Context Protocol (MCP)-Server, der Claude mit deinem Strava-Konto verbindet. Bitte Claude in natürlicher Sprache, dein Training zu analysieren, Rennzeiten vorherzusagen, Trainingsbelastungen zu berechnen oder einen vollständigen periodisierten Trainingsplan zu erstellen.

Funktionen

• 13 Tools in 5 Kategorien: Authentifizierung, Aktivitäten, Analyse, Vorhersage, Planung

• OAuth2-Ablauf mit automatischem lokalen Callback-Server — kein manuelles Kopieren von Codes

• VDOT-basierte Trainingsgeschwindigkeiten (Jack Daniels' Running Formula)

• CTL/ATL/TSB-Trainingsbelastungsmetriken (Chronische/Akute Trainingsbelastung, Training Stress Balance)

• Rennzeitvorhersagen mittels Riegel-Formel

• Vollständige periodisierte Trainingspläne (Basis → Aufbau → Höhepunkt → Tapering) mit rennspezifischer Logik

Anforderungen

• Node.js ≥ 18

• Ein Strava-Konto

• Claude Desktop (oder ein beliebiger MCP-kompatibler Client)

Einrichtung

1. Erstelle eine Strava-API-Anwendung

Gehe zu strava.com/settings/api und erstelle eine Anwendung.

• Authorization Callback Domain: localhost

Notiere dir deine Client ID und dein Client Secret.

2. Konfiguriere Umgebungsvariablen

cp .env.example .env

Bearbeite .env:

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REDIRECT_URI=http://localhost:8080/callback
TOKENS_FILE_PATH=./tokens.json

3. Build

npm install
npm run build

4. Konfiguriere Claude Desktop

Bearbeite %APPDATA%\Claude\claude_desktop_config.json (Windows) oder ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["C:/path/to/McpStrava/dist/index.js"],
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret",
        "TOKENS_FILE_PATH": "C:/path/to/McpStrava/tokens.json"
      }
    }
  }
}

Du kannst entweder .env oder den env-Block in der Claude Desktop-Konfiguration verwenden — beides funktioniert.

5. Authentifizierung

Starte Claude Desktop neu und führe dann in einer Unterhaltung folgende Schritte aus:

1. Rufe strava_get_auth_url auf — Claude gibt eine URL zurück

2. Öffne die URL in deinem Browser und autorisiere die App bei Strava

3. Die Seite zeigt "✓ Authentification réussie !" an und die Tokens werden automatisch gespeichert

Verfügbare Tools

Authentifizierung

Aktivitäten

Analyse

Vorhersage

Trainingsplanung

Details zum Trainingsplan

Phasen

Wie das Volumen berechnet wird

1. Startvolumen — Mischung aus deinem 4-Wochen-Durchschnitt in km und der CTL-basierten wöchentlichen km-Schätzung (robust bei Verletzungspausen)

2. Höchstvolumen — 1,4× aktuell, mit rennspezifischen Mindestwerten (5K: 40km, 10K: 50km, Halbmarathon: 60km, Marathon: 80km)

3. Wöchentliche Progression — begrenzt auf +10% pro Woche, um Verletzungen vorzubeugen

4. Erholungswochen — automatisch jede 4. Woche innerhalb jeder Phase (Volumen × 0,8)

Rennspezifische Logik

• Marathon (Aufbau & Höhepunkt): Lange Läufe beinhalten einen Abschnitt im Marathontempo (~45% des Laufs im Renntempo)

• Tapering-Tiefe: 5K tapert auf 80% des Höchstvolumens, Marathon auf 40% — kürzere Rennen benötigen weniger Erholung

• Intervalle: 6 × 1000m für 5K/10K, 5 × 1000m für Halbmarathon/Marathon

VDOT & Pace-Zonen

Basierend auf Jack Daniels' Running Formula. Zonen werden als Bruchteil des VDOT berechnet:

Pläne für Freunde erstellen (manueller Modus)

strava_generate_training_plan unterstützt einen manuellen Modus, der Strava komplett umgeht. Übergebe current_weekly_km und goal_time zusammen, dann ist kein Strava-Konto erforderlich — nützlich, um Pläne für Freunde von deinem eigenen Claude Desktop aus zu erstellen.

Erforderliche Parameter

Beispiel-Prompts

Génère un plan marathon pour mon ami, il court 55km par semaine et vise 3h45, la course est le 18 octobre 2026

Mon amie veut courir un semi-marathon en 1h50 le 2026-09-14, elle fait environ 40km par semaine

Wenn sowohl current_weekly_km als auch goal_time angegeben sind, überspringt das Tool alle Strava-API-Aufrufe. Die resume in der Antwort enthält source_volume: "Fourni manuellement", um zu bestätigen, welcher Modus verwendet wurde.

Modus-Vergleich

Entwicklung

# Watch mode (no build step needed)
npm run dev

# Build TypeScript
npm run build

# Run built server
npm start

# Clean build artifacts
npm run clean

Projektstruktur

src/
├── index.ts                  # MCP server entry point
├── config.ts                 # Env vars, Strava constants, race distances
├── types.ts                  # Shared TypeScript interfaces
├── auth/
│   ├── oauth.ts              # OAuth2 URL builder, token exchange
│   ├── tokenStore.ts         # Load/save tokens.json, expiry check
│   ├── callbackServer.ts     # Local HTTP server for OAuth redirect
│   └── authTools.ts          # MCP auth tools
├── strava/
│   ├── client.ts             # Axios instance with auto token refresh
│   ├── activities.ts         # Strava activities API
│   ├── athlete.ts            # Strava athlete/stats API
│   └── activityTools.ts      # MCP activity tools
├── analytics/
│   ├── metrics.ts            # Weekly stats, pace zones, consistency score
│   ├── trainingLoad.ts       # TRIMP, CTL/ATL/TSB computation
│   └── analysisTools.ts      # MCP analysis tools
├── prediction/
│   ├── riegel.ts             # Riegel race time prediction formula
│   ├── vdot.ts               # VDOT computation, training paces, race equivalents
│   └── predictionTools.ts    # MCP prediction tools
└── planning/
    ├── workouts.ts           # Workout templates and distance bounds
    ├── plan.ts               # Plan generation, phase allocation, VDOT estimation
    └── planTools.ts          # MCP planning tools

Tokens

tokens.json speichert deine Strava-Zugriffs- und Refresh-Tokens. Es befindet sich in .gitignore — committe es niemals. Tokens werden automatisch aktualisiert, wenn sie ablaufen (Strava-Zugriffstokens sind 6 Stunden gültig).

Beispiel-Prompts

Strava-Modus (dein eigenes Konto)

Analyse mes 8 dernières semaines d'entraînement

Quelle serait mon heure sur un marathon si je cours un 10K en 45min ?

Génère-moi un plan d'entraînement pour un semi-marathon le 2026-09-20

Calcule ma charge d'entraînement actuelle et dis-moi si je suis en forme pour une course ce week-end

Montre-moi la répartition de mes allures sur les 4 dernières semaines

Manueller Modus (Freunde / kein Strava)

Génère un plan marathon pour mon ami, il court 55km par semaine et vise 3h45, la course est le 18 octobre 2026

Mon amie veut courir un semi-marathon en 1h50 le 14 septembre 2026, elle fait 40km par semaine

Lizenz

MIT