Servidor Strava MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de Strava. Este servidor permite que los modelos de lenguaje interactúen con los datos de Strava, incluyendo actividades, información de los atletas y más.

Características

• 🏃‍♂️ Seguimiento y análisis de actividad

• 📊 Estadísticas de los atletas

• 🗺️ Visualización de rutas

• 🏆 Seguimiento de logros

• 🤝 Funciones sociales (felicitaciones, comentarios)

Related MCP server: Whoop MCP Server

Prerrequisitos

• Python 3.12+

• Credenciales de la API de Strava

• pip (instalador de paquetes de Python)

Instalación

1. Clonar el repositorio:

2. Crear un entorno virtual:

3. Instalar dependencias:

Configuración

1. Crea un archivo config/.env con tus credenciales de API de Strava:

2. Para obtener las credenciales de la API de Strava:

   • Vaya a https://www.strava.com/settings/api

   • Crear una nueva aplicación

   • Anote el ID del cliente y el secreto del cliente

   • Siga el flujo de OAuth 2.0 para obtener su token de actualización

Uso

Usando con Claude

Una vez conectado, podrás interactuar con tus datos de Strava a través de Claude de varias maneras:

Consultas de actividad

• "Muéstrame mis actividades recientes"

• "Obtener detalles sobre mi última carrera"

• "¿Cuál fue mi viaje más largo este mes?"

• "Muéstrame actividades donde establecí récords personales"

• "Mostrar el mapa de ruta de mi última actividad"

Análisis de rendimiento

• "¿Cuál es mi ritmo promedio de carrera este año?"

• "Compara mi rendimiento ciclista entre el mes pasado y este mes"

• "Muéstrame mis zonas de frecuencia cardíaca del entrenamiento de ayer"

• "¿Cuál es mi ganancia de elevación total para todas las actividades?"

• Calcula mi kilometraje semanal para correr

Interacciones sociales

• "¿Quién me dio elogios por mi última actividad?"

• "Muéstrame comentarios sobre mi maratón"

• "Enumerar todas las actividades de mi club"

• "Encuentra actividades que hice con amigos"

Seguimiento de logros

• "Enumerar todos mis logros del segmento"

• "Mostrar mis récords personales en segmentos locales"

• ¿Qué logros obtuve esta semana?

• "Mostrar mi progreso en los objetivos anuales"

Datos disponibles a través de Claude

1. Detalles de la actividad:

   • Distancia, duración, ritmo

   • Mapas de rutas y perfiles de elevación

   • Datos de frecuencia cardíaca, potencia y cadencia

   • Información sobre vueltas y tiempos parciales

   • Condiciones climáticas durante la actividad

2. Estadísticas de atletas:

   • Totales del año hasta la fecha y de todos los tiempos

   • Récords y logros personales

   • Carga de entrenamiento y tendencias de fitness

   • Uso y mantenimiento de equipos

3. Datos sociales:

   • Felicitaciones y comentarios

   • Actividades del club y tablas de clasificación

   • Actividades y desafíos entre amigos

   • Esfuerzos y clasificaciones de segmentos

4. Información de ruta:

   • Mapas detallados con datos de elevación

   • Análisis de segmentos

   • Rutas y segmentos populares

   • Planificación y análisis de rutas

Como servidor MCP

Actualice la configuración de Claude Desktop:

Como servidor HTTP

1. Iniciar el servidor:

2. Acceda a la API en http://localhost:8000

Puntos finales disponibles:

• GET /activities/recent - Lista de actividades recientes

• GET /activities/{id} - Obtener detalles de la actividad

• GET /activities/{id}/map - Obtener la visualización del mapa de actividades

• GET /athlete/stats - Obtener estadísticas de atletas

Desarrollo

Estructura del proyecto

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Seguridad

• Nunca confirmes archivos .env ni credenciales de API

• El archivo .gitignore está configurado para evitar que se envíen datos confidenciales

• Utilice variables de entorno para todas las configuraciones sensibles

Licencia

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

Expresiones de gratitud

• Documentación de la API de Strava

• Especificación del Protocolo de Contexto de Modelo (MCP)

• Colaboradores y mantenedores