strava mcp

MCP Strava Server

Um servidor Model Context Protocol (MCP) que integra o Strava com o Claude for Desktop, permitindo análise com IA das suas atividades físicas.

Funcionalidades

• ⭐ Geração de Rotas - sugira rotas de ida e volta com um link do Google Maps (sem necessidade de chave de API)
• ⭐ Rotas Populares - descubra segmentos populares do Strava nas proximidades e obtenha um circuito no Google Maps passando por eles
• Autenticação OAuth com atualização automática de token e persistência
• Análise de Atividades - obtenha detalhes de qualquer atividade por ID, ou navegue pelas recentes
• Fluxos de Dados - frequência cardíaca, ritmo, altitude, cadência, potência, GPS para qualquer atividade
• Divisões por Volta - distância, tempo, velocidade, elevação e frequência cardíaca por volta
• Melhores Esforços Pessoais - os mais rápidos 400m, 1k, 1 milha, 5k, 10k, etc. para uma corrida, com ritmo e classificação de PR
• Pesquisa Paginada - encontre atividades por intervalo de datas com paginação completa
• Comparações Históricas - compare meses ano a ano
• Estatísticas - estatísticas de todos os tempos, resumos semanais/mensais
• Filtragem - por tipo de atividade (Corrida, Pedal, Natação, etc.)

Ferramentas Disponíveis

Ferramenta	Descrição
auth_strava	Autorize com o Strava (abre o navegador)
logout	Limpe os tokens armazenados para trocar de conta
last_activity	Obtenha detalhes da sua atividade mais recente
get_activity	Busque qualquer atividade pelo seu ID
recent_activities	Liste as últimas 10 atividades
search_activities	Pesquisa paginada com intervalo de datas opcional (before/after epoch, page, per_page)
athlete_stats	Estatísticas de todos os tempos (pedais, corridas, natações)
activities_by_type	Filtre atividades por tipo de esporte
weekly_summary	Resumo dos últimos 7 dias
monthly_summary	Resumo dos últimos 30 dias
month_summary	Resumo para um mês/ano específico
compare_months	Compare dois meses (ex.: Jan 2025 vs Jan 2026)
get_streams	Dados de frequência cardíaca da última atividade
get_activity_streams	Fluxos de dados completos (HR, ritmo, altitude, cadência, potência, GPS, etc.) para qualquer atividade
get_laps	Divisões por volta para qualquer atividade (distância, tempo, velocidade, elevação, HR)
get_best_efforts	Melhores esforços pessoais (400m, 1k, 1 milha, 5k, 10k, …) para uma corrida, com ritmo e classificação de PR
suggest_route	Gere uma rota de ida e volta e obtenha um link do Google Maps para navegação
popular_routes	Encontre segmentos populares do Strava nas proximidades e crie uma rota no Google Maps passando por eles

Configuração

1. Clone o Repositório

git clone https://github.com/MariyaFilippova/mcp-strava.git
cd mcp-strava

2. Configure as Credenciais da API do Strava

Obtenha suas credenciais nas configurações da API do Strava.

Crie/edite src/main/resources/.env:

CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"

3. Compile o Projeto

./gradlew shadowJar

O JAR estará em: build/libs/strava-mcp-server-2.1.0-all.jar

4. Configure o Claude for Desktop

Edite o arquivo de configuração do Claude:

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

Adicione o servidor MCP:

{
  "mcpServers": {
    "strava": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/mcp-strava/build/libs/strava-mcp-server-2.1.0-all.jar"
      ]
    }
  }
}

Reinicie o Claude for Desktop.

Exemplos de Uso

Depois de configurado, você pode pedir ao Claude coisas como:

• "Mostre-me minhas atividades recentes do Strava"
• "Quais são minhas estatísticas de corrida de todos os tempos?"
• "Compare meu janeiro de 2025 com janeiro de 2026"
• "Dê-me um resumo do meu ciclismo esta semana"
• "Como meu treino deste mês se compara ao mês passado?"
• "Mostre-me as divisões por volta da atividade 123456789"
• "Analise os dados de frequência cardíaca e elevação da minha última corrida"
• "Encontre todas as minhas atividades de março de 2025"
• "Sugira uma rota de corrida de 5km começando no Central Park, NYC"
• "Gere uma rota de ciclismo de 10km a partir de 48.8566, 2.3522"
• "Encontre segmentos populares de corrida perto do Central Park, NYC"
• "Mostre-me rotas de ciclismo populares em um raio de 10km de Paris"

Autenticação

No primeiro uso, o servidor abrirá seu navegador para autorização do Strava. Os tokens são persistidos em ~/.strava-mcp-token.json e atualizados automaticamente quando expiram.

Use a ferramenta logout para limpar os tokens armazenados se precisar trocar de conta.

Licença

MIT