Strava MCP Server

Servidor Strava MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Strava.

Guía del usuario

Instalación

Puedes instalar fácilmente Strava MCP con uvx :

Configuración de credenciales de Strava

1. Crear una aplicación API de Strava :
   • Vaya a https://www.strava.com/settings/api
   • Cree una nueva aplicación para obtener su ID de cliente y secreto de cliente
   • Para "Dominio de devolución de llamada de autorización", ingrese localhost
2. Configure sus credenciales : cree un archivo de credenciales (por ejemplo, ~/.ssh/strava.sh ):
   export STRAVA_CLIENT_ID=your_client_id export STRAVA_CLIENT_SECRET=your_client_secret
3. Configurar Claude Desktop : agregue lo siguiente a su configuración de Claude ( /Users/<username>/Library/Application Support/Claude/claude_desktop_config.json ):
   "strava": { "command": "bash", "args": [ "-c", "source ~/.ssh/strava.sh && uvx strava-mcp" ] }

Autenticación

La primera vez que utilice las herramientas Strava MCP:

1. Se iniciará automáticamente un flujo de autenticación.
2. Su navegador se abrirá en la página de autorización de Strava.
3. Después de autorizar, será redirigido a una página local.
4. Su token de actualización se guardará automáticamente para uso futuro

Herramientas disponibles

Obtener actividades del usuario

Recupera actividades del usuario autenticado.

Parámetros:

• before (opcional): Marca de tiempo de época para filtrar
• after (opcional): Marca de tiempo de época para filtrar
• page (opcional): Número de página (predeterminado: 1)
• per_page (opcional): Número de elementos por página (predeterminado: 30)

Obtener actividad

Obtiene información detallada sobre una actividad específica.

Parámetros:

• activity_id : El ID de la actividad
• include_all_efforts (opcional): incluye esfuerzos del segmento (predeterminado: falso)

Obtener segmentos de actividad

Recupera segmentos de una actividad específica.

Parámetros:

• activity_id : El ID de la actividad

Obtener la tabla de clasificación del segmento

Obtiene la tabla de clasificación para un segmento específico.

Parámetros:

• segment_id : El ID del segmento
• Varios filtros opcionales (género, grupo de edad, etc.)

Guía para desarrolladores

Configuración del proyecto

1. Clonar el repositorio:
   git clone <repository-url> cd strava
2. Instalar dependencias:
   uv install
3. Configurar variables de entorno:
   export STRAVA_CLIENT_ID=your_client_id export STRAVA_CLIENT_SECRET=your_client_secret
   Alternativamente, cree un archivo .env con estas variables.

Ejecutando en modo de desarrollo

Ejecute el servidor con MCP CLI:

Autenticación manual

Puede obtener un token de actualización manualmente ejecutando:

Estructura del proyecto

• strava_mcp/ : Directorio principal del paquete
  • __init__.py : Inicialización del paquete
  • config.py : Ajustes de configuración mediante pydantic-settings
  • models.py : Modelos de Pydantic para entidades de la API de Strava
  • api.py : Cliente API de bajo nivel para Strava
  • auth.py : Implementación de la autenticación OAuth de Strava
  • oauth_server.py : Implementación de servidor OAuth independiente
  • service.py : Capa de servicio para la lógica empresarial
  • server.py : implementación del servidor MCP
• tests/ : Pruebas unitarias
• strava_mcp/main.py : Punto de entrada principal para ejecutar el servidor
• get_token.py : script de utilidad para obtener un token de actualización manualmente

Ejecución de pruebas

Publicación en PyPI

Construyendo el paquete

Publicación en PyPI

Licencia

Licencia MIT

Expresiones de gratitud

• API de Strava
• Protocolo de Contexto Modelo (MCP)