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 ).

Related MCP server: Whoop MCP Server

Formato de datos de actividad

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

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.