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)
Prerrequisitos
- Python 3.12+
- Credenciales de la API de Strava
- pip (instalador de paquetes de Python)
Instalación
- Clonar el repositorio:
git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp
- Crear un entorno virtual:
python -m venv venv
source venv/bin/activate # On Windows: .\venv\Scripts\activate
- Instalar dependencias:
pip install -r requirements.txt
Configuración
- Crea un archivo
config/.env con tus credenciales de API de Strava:
STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token
- 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
- 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
- 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
- Datos sociales:
- Felicitaciones y comentarios
- Actividades del club y tablas de clasificación
- Actividades y desafíos entre amigos
- Esfuerzos y clasificaciones de segmentos
- 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:
{
"mcpServers": {
"Strava": {
"command": "python",
"args": ["src/strava_server.py"],
"cwd": "/path/to/strava_mcp",
"env": {
"STRAVA_CLIENT_ID": "your_client_id",
"STRAVA_CLIENT_SECRET": "your_client_secret",
"STRAVA_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}
Como servidor HTTP
- Iniciar el servidor:
- 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
strava_mcp/
├── src/
│ ├── strava_server.py # MCP server implementation
│ ├── strava_http_server.py # HTTP API server
│ ├── map_utils.py # Map visualization utilities
│ └── templates.py # HTML templates
├── config/
│ └── .env # Environment variables (not in git)
├── requirements.txt # Python dependencies
└── run_server.sh # Server startup script
Contribuyendo
- Bifurcar el repositorio
- Crear una rama de características
- Confirme sus cambios
- Empujar hacia la rama
- 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