Strava MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to the Strava API, allowing queries for athlete activities including recent activities, activities by date range, specific activity details, and activities from a recent time period. Data returned includes activity metrics like distance, time, speed, elevation, and calories.

Servidor Strava MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de Strava. Permite que los modelos de lenguaje consulten los datos de actividad de los atletas desde la API de Strava.

Herramientas disponibles

El servidor expone las siguientes herramientas:

Consultas de actividades

  • get_activities(limit: int = 10) : Obtener las actividades recientes del atleta autenticado
  • get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30) : Obtener actividades dentro de un rango de fechas específico
  • get_activity_by_id(activity_id: int) : Obtener información detallada sobre una actividad específica
  • get_recent_activities(days: int = 7, limit: int = 10) : Obtener actividades de los últimos X días

Las fechas deben proporcionarse en formato ISO ( YYYY-MM-DD ).

Formato de datos de actividad

El servidor devuelve datos de actividad con nombres de campo y unidades consistentes:

CampoDescripciónUnidad
nameNombre de la actividad-
sport_typeTipo de deporte-
start_dateFecha y hora de inicioISO 8601
distance_metresDistanciametros
elapsed_time_secondsTiempo total transcurridoartículos de segunda clase
moving_time_secondsTiempo de mudanzaartículos de segunda clase
average_speed_mpsVelocidad mediametros por segundo
max_speed_mpsVelocidad máximametros por segundo
total_elevation_gain_metresGanancia de elevación totalmetros
elev_high_metresElevación más altametros
elev_low_metresElevación más bajametros
caloriesCalorías quemadaskcal
start_latlngCoordenadas de inicio[latitud, longitud]
end_latlngCoordenadas finales[latitud, longitud]

Autenticación

Para usar este servidor, deberás autenticarte con la API de Strava. Sigue estos pasos:

  1. Crear una aplicación API de Strava:
    • Ir a la configuración de la API de Strava
    • Crea una aplicación para obtener tu ID de cliente y tu secreto de cliente
    • Establezca el dominio de devolución de llamada de autorización en localhost
  2. Obtenga su token de actualización:
    • Utilice el script get_strava_token.py incluido: GXP1
    • Siga las instrucciones para autorizar su solicitud.
    • El script guardará sus tokens en un archivo .env
  3. Establecer variables de entorno: el servidor requiere las siguientes variables de entorno:
    • STRAVA_CLIENT_ID : Su ID de cliente de la API de Strava
    • STRAVA_CLIENT_SECRET : Su secreto de cliente de la API de Strava
    • STRAVA_REFRESH_TOKEN : Su token de actualización de la API de Strava

Uso

Claude para escritorio

Actualice su claude_desktop_config.json (ubicado en ~/Library/Application\ Support/Claude/claude_desktop_config.json en macOS y %APPDATA%/Claude/claude_desktop_config.json en Windows) para incluir lo siguiente:

{ "mcpServers": { "strava": { "command": "uvx", "args": [ "strava-mcp-server" ], "env": { "STRAVA_CLIENT_ID": "YOUR_CLIENT_ID", "STRAVA_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "STRAVA_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN" } } } }

Claude Web

Para Claude Web, puedes ejecutar el servidor localmente y conectarlo usando la extensión MCP.

Consultas de ejemplo

Una vez conectado, puedes hacerle preguntas a Claude como:

  • "¿Cuales son mis actividades recientes?"
  • "Muéstrame mis actividades de la semana pasada"
  • "¿Cuál fue mi carrera más larga en el último mes?"
  • "Obtener detalles sobre mi última actividad ciclista"

Manejo de errores

El servidor proporciona mensajes de error legibles por humanos para problemas comunes:

  • Formatos de fecha no válidos
  • Errores de autenticación de API
  • Problemas de conectividad de red

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor de protocolo de contexto de modelo que proporciona modelos de lenguaje con acceso a los datos de la API de Strava, lo que les permite consultar y analizar las actividades de los atletas desde Strava.

  1. Available Tools
    1. Activities Queries
  2. Activity Data Format
    1. Authentication
      1. Usage
        1. Claude for Desktop
        2. Claude Web
      2. Example Queries
        1. Error Handling
          1. License
            ID: kjgj5ovtdq