74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
# Strava MCP
|
|
|
|
Diese Anwendung besteht aus einer NestJS API, einem Angular Client und einem MCP-Server fuer KI-Zugriff auf die synchronisierten Strava-Daten.
|
|
|
|
## MCP starten
|
|
|
|
Im Docker-Container startet der MCP-Server automatisch als HTTP-Endpunkt. nginx veroeffentlicht ihn unter `/mcp` auf demselben Port wie den Client.
|
|
|
|
```bash
|
|
docker run -d --env-file .env -p 8080:80 --name strava-mcp 192.168.30.40:3000/bastian/strava-mcp:latest
|
|
```
|
|
|
|
Der MCP-Endpunkt ist dann erreichbar unter:
|
|
|
|
```text
|
|
http://<server>:8080/mcp
|
|
```
|
|
|
|
Optional kann der Endpunkt mit `MCP_AUTH_TOKEN` geschuetzt werden. MCP-Clients muessen dann den Header `Authorization: Bearer <token>` senden.
|
|
|
|
Fuer lokale stdio-Nutzung gibt es weiterhin einen separaten Einstieg. Die `.env` kann im Repository-Root oder im `api`-Ordner liegen.
|
|
|
|
```bash
|
|
cd api
|
|
npm run build
|
|
npm run start:mcp
|
|
```
|
|
|
|
Beispiel fuer einen MCP-Client:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"strava": {
|
|
"command": "node",
|
|
"args": ["C:/repositories/strava-mcp/api/dist/mcp-main.js"],
|
|
"env": {
|
|
"DATABASE_HOST": "mysql.example.internal",
|
|
"DATABASE_PORT": "3306",
|
|
"DATABASE_USER": "strava_app",
|
|
"DATABASE_PASSWORD": "change-me",
|
|
"DATABASE_NAME": "strava_app",
|
|
"APP_ENCRYPTION_KEY": "change-me-to-a-long-random-secret",
|
|
"STRAVA_CLIENT_ID": "change-me",
|
|
"STRAVA_CLIENT_SECRET": "change-me",
|
|
"STRAVA_REDIRECT_URI": "http://localhost:3000/auth/strava/callback"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Der HTTP-MCP kann lokal auch ohne Docker gestartet werden:
|
|
|
|
```bash
|
|
cd api
|
|
npm run build
|
|
npm run start:mcp:http
|
|
```
|
|
|
|
## MCP Tools
|
|
|
|
- `get_athlete_profile`: verbundenes Strava-Profil, Aktivitaetsanzahl, Sportarten und neueste Aktivitaet.
|
|
- `get_training_dashboard`: Summen, Durchschnitte, Wochenverlauf, Sportarten und letzte Aktivitaeten.
|
|
- `get_running_summary`: Laufumfang, Pace, laengster Lauf, Hoehenmeter und Wochenverlauf.
|
|
- `get_running_kpis`: Load, Acute/Chronic Ratio, Monotony, Recovery, Intensitaetsverteilung, Progression und PR-Schaetzungen.
|
|
- `list_activities`: Aktivitaeten nach Zeitraum, Sportart und Name suchen.
|
|
- `get_activity_detail`: Details zu einer Aktivitaet, optional mit begrenzten Stream-Punkten und Raw Payload.
|
|
- `get_running_activity_detail`: Laufdetails mit Splits und Serien.
|
|
- `get_sync_status`: letzter Strava-Sync-Job.
|
|
- `start_strava_sync`: startet oder reaktiviert den Strava-Sync.
|
|
|
|
Zusätzlich gibt es den Prompt `training_review`, der eine KI zur strukturierten Analyse der Trainingsdaten anleitet.
|