strava mcp

MCP Strava Server

Un servidor de Model Context Protocol (MCP) que integra Strava con Claude para Desktop, permitiendo análisis impulsados por IA de tus actividades de fitness.

Características

• ⭐ Generación de Rutas - sugiere rutas de ida y vuelta con un enlace de Google Maps (sin necesidad de clave API)
• ⭐ Rutas Populares - descubre segmentos populares de Strava cercanos y obtén un bucle de Google Maps a través de ellos
• Autenticación OAuth con renovación automática y persistencia de tokens
• Análisis de Actividades - obtén detalles de cualquier actividad por ID, o explora las recientes
• Flujos de Datos - frecuencia cardíaca, ritmo, altitud, cadencia, potencia, GPS para cualquier actividad
• Divisiones por Vuelta - distancia, tiempo, velocidad, elevación y frecuencia cardíaca por vuelta
• Mejores Esfuerzos Personales - 400m, 1k, 1 milla, 5k, 10k, etc. más rápidos para una carrera, con ritmo y clasificación de RP
• Búsqueda Paginada - encuentra actividades por rango de fechas con paginación completa
• Comparaciones Históricas - compara meses año tras año
• Estadísticas - estadísticas de todos los tiempos, resúmenes semanales/mensuales
• Filtrado - por tipo de actividad (Correr, Rodar, Nadar, etc.)

Herramientas Disponibles

Herramienta	Descripción
auth_strava	Autorizar con Strava (abre el navegador)
logout	Borrar los tokens almacenados para cambiar de cuenta
last_activity	Obtener detalles de tu actividad más reciente
get_activity	Obtener cualquier actividad por su ID
recent_activities	Listar las últimas 10 actividades
search_activities	Búsqueda paginada con rango de fechas opcional (before/after epoch, page, per_page)
athlete_stats	Estadísticas de todos los tiempos (rodadas, carreras, natación)
activities_by_type	Filtrar actividades por tipo de deporte
weekly_summary	Resumen de los últimos 7 días
monthly_summary	Resumen de los últimos 30 días
month_summary	Resumen para un mes/año específico
compare_months	Comparar dos meses (p. ej., ene 2025 vs ene 2026)
get_streams	Datos de frecuencia cardíaca de la última actividad
get_activity_streams	Flujos de datos completos (FC, ritmo, altitud, cadencia, potencia, GPS, etc.) para cualquier actividad
get_laps	Divisiones por vuelta para cualquier actividad (distancia, tiempo, velocidad, elevación, FC)
get_best_efforts	Mejores esfuerzos personales (400m, 1k, 1 milla, 5k, 10k, …) para una carrera, con ritmo y clasificación de RP
suggest_route	Generar una ruta de ida y vuelta y obtener un enlace de Google Maps para navegación
popular_routes	Encontrar segmentos populares de Strava cercanos y construir una ruta de Google Maps a través de ellos

Configuración

1. Clonar el Repositorio

git clone https://github.com/MariyaFilippova/mcp-strava.git
cd mcp-strava

2. Configurar las Credenciales de la API de Strava

Obtén tus credenciales en Configuración de la API de Strava.

Crea/edita src/main/resources/.env:

CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"

3. Compilar el Proyecto

./gradlew shadowJar

El JAR estará en: build/libs/strava-mcp-server-2.1.0-all.jar

4. Configurar Claude para Desktop

Edita el archivo de configuración de Claude:

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

Añade el servidor MCP:

{
  "mcpServers": {
    "strava": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/mcp-strava/build/libs/strava-mcp-server-2.1.0-all.jar"
      ]
    }
  }
}

Reinicia Claude para Desktop.

Ejemplos de Uso

Una vez configurado, puedes pedirle a Claude cosas como:

• "Muéstrame mis actividades recientes de Strava"
• "¿Cuáles son mis estadísticas de carrera de todos los tiempos?"
• "Compara mi enero de 2025 con enero de 2026"
• "Dame un resumen de mi ciclismo de esta semana"
• "¿Cómo se comparó mi entrenamiento de este mes con el del mes pasado?"
• "Muéstrame las divisiones por vuelta de la actividad 123456789"
• "Analiza los datos de frecuencia cardíaca y elevación de mi última carrera"
• "Encuentra todas mis actividades de marzo de 2025"
• "Sugiere una ruta de carrera de 5 km que empiece en Central Park, Nueva York"
• "Genera una ruta de ciclismo de 10 km desde 48.8566, 2.3522"
• "Encuentra segmentos populares de carrera cerca de Central Park, Nueva York"
• "Muéstrame rutas de ciclismo populares a menos de 10 km de París"

Autenticación

En el primer uso, el servidor abrirá tu navegador para la autorización de Strava. Los tokens se guardan en ~/.strava-mcp-token.json y se renuevan automáticamente cuando caducan.

Usa la herramienta logout para borrar los tokens almacenados si necesitas cambiar de cuenta.

Licencia

MIT