F1 MCP Server

Fornece análise avançada de dados da Fórmula 1, incluindo telemetria em tempo real, desempenho de pneus, previsão meteorológica e simulação de estratégia de corrida.

GitHub
5
Experimente este MCPPatrocinado

Documentação

F1 MCP Server

Servidor MCP Avançado de Análise de Dados de Fórmula 1 - Telemetria em tempo real, análise de desempenho de pneus e simulação de estratégia de corrida para Claude

Um servidor sofisticado de Model Context Protocol (MCP) que fornece ao Claude capacidades avançadas de análise de Fórmula 1, incluindo processamento de telemetria em tempo real, modelagem de degradação de pneus, análise de impacto climático e simulação de estratégia de corrida Monte Carlo.

🏎️ Recursos

12 Ferramentas Poderosas de Análise de F1

Ferramentas Principais de Análise (8)

  • Análise de Dados de Sessão - Dados abrangentes de fim de semana de corrida com telemetria e clima
  • Análise de Desempenho de Pneus - Modelagem avançada de degradação com análise térmica
  • Análise de Tempo de Volta - Análise corrigida por combustível com detalhamento de 25 mini-setores
  • Previsão de Impacto Climático - Previsão LSTM/CNN com recomendações estratégicas
  • Simulação de Estratégia de Corrida - Simulação Monte Carlo com 300M-1B+ permutações
  • Análise de Desempenho do Piloto - Extração de habilidade separando desempenho do carro vs. piloto
  • Processamento de Telemetria em Tempo Real - Análise avançada de sinais com detecção de anomalias
  • Análise de Desempenho de Setores - Análise de 25 mini-setores com correlação de curvatura da pista

Ferramentas de Dados ao Vivo 2025 (4)

  • Informações da Temporada Atual - Dados ao vivo da temporada de F1 com status em tempo real
  • Calendário de Corridas - Calendário completo de F1 para as temporadas 2018-2025
  • Conexão de Tempo ao Vivo - Integração com a API oficial de Live Timing da F1
  • Monitoramento de Status da API - Status em tempo real de todas as fontes de dados da F1

Capacidades Avançadas de Análise

  • Modelos Matemáticos: Física sofisticada de degradação de pneus com fatores térmicos, mecânicos e químicos
  • Processamento de Sinais: FFT, análise de wavelets e filtragem de Kalman para dados de telemetria
  • Modelagem Climática: Previsão por conjunto (ensemble) com modelos híbridos LSTM/CNN
  • Otimização de Estratégia: Simulação Monte Carlo com resultados probabilísticos e análise de risco
  • Extração de Desempenho: Análise de habilidade do piloto com divisão de desempenho carro/piloto de 88%/12%

📋 Pré-requisitos

  • Node.js 18.0.0 ou superior
  • npm (incluído com Node.js)
  • Aplicativo Claude Desktop

🚀 Instalação

Passo 1: Clone e Configuração do Servidor

# Clone the repository
git clone https://github.com/stagsz/F1-MCP-Server
cd F1-mcp-server

# Install dependencies
npm install

# Verify installation
npm test

Passo 2: Configurar o Claude Desktop

Você precisa adicionar este servidor MCP ao seu arquivo de configuração do Claude Desktop.

Windows

Edite o arquivo em: %APPDATA%\Claude\claude_desktop_config.json

macOS

Edite o arquivo em: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux

Edite o arquivo em: ~/.config/Claude/claude_desktop_config.json

Passo 3: Adicionar Configuração do Servidor

Adicione a seguinte configuração ao seu arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "node",
      "args": ["path/to/F1-mcp-server/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Importante: Substitua path/to/F1-mcp-server/index.js pelo caminho absoluto do seu diretório F1-mcp-server.

Exemplos de configuração:

Windows:

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\F1-mcp-server\\index.js"]
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "node", 
      "args": ["/home/username/F1-mcp-server/index.js"]
    }
  }
}

Passo 4: Reiniciar o Claude Desktop

Após salvar o arquivo de configuração, saia completamente e reinicie o Claude Desktop para que as alterações tenham efeito.

🔧 Verificação

Quando o Claude Desktop reiniciar, você pode verificar se o F1 MCP Server está funcionando perguntando ao Claude:

Can you analyze tire performance for a Formula 1 race?

O Claude agora deve ter acesso a todas as capacidades de análise de F1 e usará o servidor MCP para fornecer análises detalhadas.

📚 Exemplos de Uso

Análise de Desempenho de Pneus

Analyze tire degradation for Lewis Hamilton using medium compound tires in the 2024 Monaco Grand Prix race session.

Simulação de Estratégia de Corrida

Run a Monte Carlo simulation comparing one-stop vs two-stop strategies for Max Verstappen at Silverstone 2024.

Análise de Impacto Climático

Predict weather impact for the next 3 hours during qualifying at Spa-Francorchamps and recommend tire strategy.

Análise de Desempenho do Piloto

Analyze Charles Leclerc's driving performance and extract his skill level compared to car performance at Monza 2024.

Análise de Tempo de Volta

Perform fuel-corrected lap time analysis for George Russell in Practice 2, including mini-sector breakdown.

Telemetria em Tempo Real

Process real-time telemetry data for Fernando Alonso focusing on speed, throttle, and brake channels.

🛠️ Desenvolvimento

Testes

# Run test suite
npm test

# Run tests with coverage
npm run test -- --coverage

# Check syntax
node --check index.js

Modo de Desenvolvimento

# Start with auto-reload
npm run dev

# Check logs
tail -f logs/combined.log

Depuração

# Enable debug logging
export LOG_LEVEL=debug
npm start

📊 Especificações Técnicas

Processamento de Dados

  • Volume de Telemetria: 1,1M+ pontos de dados por segundo de simulação
  • Taxa de Amostragem: Simulação de 100Hz
  • Monte Carlo: 300M a 1B+ permutações por corrida
  • Processamento de Sinais: FFT, análise de wavelets, filtragem de Kalman

Modelos Matemáticos

  • Degradação de Pneus: Fatores térmicos, mecânicos e químicos
  • Previsão do Tempo: Modelos de conjunto LSTM/CNN
  • Análise do Piloto: Divisão de desempenho carro/piloto de 88%/12%
  • Otimização de Estratégia: Modelagem probabilística de resultados

Dados de F1 Suportados e Integração ao Vivo

  • Anos: 2018-2025 (incluindo a temporada atual de 2025)
  • Sessões: Treinos 1-3, Classificação, Sprint, Corrida
  • Fontes de Dados: F1 Live Timing → OpenF1 API → Ergast API → Simulação Avançada
  • Dados ao Vivo: Telemetria em tempo real durante sessões ativas de F1
  • Compostos de Pneus: C1-C6, Macio/Médio/Duro, Intermediários, Chuva
  • Clima: Condições ao vivo, temperatura, umidade, probabilidade de chuva, vento
  • Telemetria: Velocidade, acelerador, freio, DRS, marcha, RPM, temperaturas dos pneus, coordenadas GPS

🚨 Solução de Problemas

Servidor Não Inicia

# Check Node.js version
node --version  # Should be 18.0.0+

# Verify dependencies
npm install

# Check syntax
node --check index.js

Claude Não Encontra o Servidor

  1. Verifique se o caminho em claude_desktop_config.json é absoluto e correto
  2. Certifique-se de que o Claude Desktop foi completamente reiniciado após alterações na configuração
  3. Verifique se o Node.js está no PATH do seu sistema

Problemas de Permissão (macOS/Linux)

# Make index.js executable
chmod +x index.js

# Check file permissions
ls -la index.js

Problemas de Dependências

# Clear cache and reinstall
rm -rf node_modules package-lock.json
npm install

📖 Documentação Completa das Ferramentas

Ferramentas Principais de Análise

🏁 get_session_data

Obtenha dados abrangentes de sessão de F1, incluindo telemetria, tempos e clima

Parâmetros:

  • year (obrigatório): Ano da corrida (2018-2025)
  • round (obrigatório): Número da rodada da corrida (1-24)
  • session (obrigatório): Tipo de sessão
    • Practice 1, Practice 2, Practice 3
    • Qualifying, Sprint, Race

Exemplo:

Get session data for 2024 Monaco Grand Prix qualifying

Retorna: Visão geral abrangente da sessão com tempos de volta, condições climáticas, uso de pneus e resumos de telemetria.

🏎️ analyze_tire_performance

Análise avançada de desempenho de pneus com modelagem de degradação e insights estratégicos

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • session (obrigatório): Tipo de sessão
  • driver (opcional): Abreviação do piloto (HAM, VER, LEC, etc.)
  • compound (opcional): Composto de pneu (SOFT, MEDIUM, HARD)

Exemplo:

Analyze tire degradation for Lewis Hamilton using medium compound tires in the 2024 Monaco Grand Prix race session

Retorna: Análise detalhada de pneus incluindo:

  • Curvas de degradação com modelagem térmica
  • Padrões de perda de aderência e durações ideais de stint
  • Recomendações estratégicas para trocas de pneus
  • Comparação de desempenho entre compostos

⏱️ analyze_lap_times

Análise sofisticada de tempo de volta com correção de combustível e detalhamento de mini-setores

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • session (obrigatório): Tipo de sessão
  • driver (opcional): Abreviação do piloto
  • fuel_corrected (opcional): Aplicar correção de combustível (padrão: true)

Exemplo:

Perform fuel-corrected lap time analysis for George Russell in Practice 2, including mini-sector breakdown

Retorna: Análise avançada de tempo de volta com:

  • Tempos de volta corrigidos por combustível e análise de ritmo
  • Detalhamento de desempenho de 25 mini-setores
  • Evolução da pista e progressão da sessão
  • Análise comparativa em relação ao pelotão

🌦️ predict_weather_impact

Análise e previsão de impacto climático para estratégia de corrida

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • session (obrigatório): Tipo de sessão
  • forecast_hours (opcional): Janela de previsão em horas (padrão: 3)

Exemplo:

Predict weather impact for the next 3 hours during qualifying at Spa-Francorchamps and recommend tire strategy

Retorna: Análise climática abrangente incluindo:

  • Previsão climática por conjunto LSTM/CNN
  • Previsões de probabilidade e intensidade de chuva
  • Recomendações estratégicas para escolha de pneus
  • Janelas de tempo para condições ideais de pista

🎯 simulate_race_strategy

Simulação de estratégia de corrida Monte Carlo com resultados probabilísticos

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • driver (obrigatório): Abreviação do piloto
  • strategy_options (opcional): Array de estratégias (ex.: ["soft-medium", "medium-hard"])
  • simulations (opcional): Número de simulações Monte Carlo (padrão: 10.000)

Exemplo:

Run a Monte Carlo simulation comparing one-stop vs two-stop strategies for Max Verstappen at Silverstone 2024

Retorna: Análise estratégica detalhada com:

  • Simulação Monte Carlo com 300M-1B+ permutações
  • Resultados probabilísticos e taxas de sucesso
  • Análise de risco e janelas ideais de pit stop
  • Recomendações de estratégia com intervalos de confiança

👨‍💼 analyze_driver_performance

Extração de desempenho do piloto separando habilidade do desempenho do carro

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • session (obrigatório): Tipo de sessão
  • driver (obrigatório): Abreviação do piloto
  • comparison_driver (opcional): Piloto para comparação

Exemplo:

Analyze Charles Leclerc's driving performance and extract his skill level compared to car performance at Monza 2024

Retorna: Análise avançada do piloto incluindo:

  • Extração de habilidade com divisão de desempenho carro/piloto de 88%/12%
  • Análise de estilo de pilotagem e métricas de desempenho
  • Comparação com companheiro de equipe ou piloto especificado
  • Identificação de pontos fortes e áreas de melhoria

📡 get_real_time_telemetry

Processamento de dados de telemetria em tempo real com análise avançada de sinais

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • session (obrigatório): Tipo de sessão
  • driver (obrigatório): Abreviação do piloto
  • lap (opcional): Número específico da volta
  • channels (opcional): Array de canais de telemetria para análise

Canais Disponíveis:

  • Speed, Throttle, Brake, DRS, Gear, RPM
  • TireTemp, BrakeTemp, GPS, EngineTemp

Exemplo:

Process real-time telemetry data for Fernando Alonso focusing on speed, throttle, and brake channels

Retorna: Análise abrangente de telemetria com:

  • Processamento de dados de alta frequência (simulação de 100Hz)
  • FFT, análise de wavelets e filtragem de Kalman
  • Detecção de anomalias e otimização de desempenho
  • Análise comparativa e recomendações de configuração

🏁 analyze_sector_performance

Análise de 25 mini-setores com correlação de curvatura da pista

Parâmetros:

  • year (obrigatório): Ano da corrida
  • round (obrigatório): Número da rodada da corrida
  • session (obrigatório): Tipo de sessão
  • driver (opcional): Abreviação do piloto

Exemplo:

Analyze sector performance for all drivers in 2024 Hungarian Grand Prix qualifying with track curvature correlation

Retorna: Análise detalhada de setores incluindo:

  • Detalhamento de desempenho de 25 mini-setores
  • Correlação de curvatura e elevação da pista
  • Análise de speed trap e desempenho em curvas
  • Recomendações de configuração e pilotagem específicas por setor

Ferramentas de Dados ao Vivo 2025

📅 get_current_season_info

Obtenha informações da temporada atual de F1, incluindo disponibilidade de dados ao vivo

Parâmetros:

  • include_live_status (opcional): Incluir status da sessão ao vivo (padrão: true)

Exemplo:

Get current F1 season information with live data status

Retorna: Visão geral da temporada atual com status de disponibilidade de dados ao vivo.

🗓️ get_race_schedule

Obtenha o calendário de corridas de F1 para qualquer ano, incluindo 2025

Parâmetros:

  • year (obrigatório): Ano da corrida (2018-2025)

Exemplo:

Get the complete 2025 F1 race schedule

Retorna: Calendário completo de corridas com datas, locais e horários das sessões.

🔴 connect_live_timing

Conecte-se à API oficial de Live Timing da F1 para dados em tempo real

Parâmetros: Nenhum

Exemplo:

Connect to F1 Official Live Timing API

Retorna: Status da conexão de live timing e feeds de dados em tempo real disponíveis.

📊 get_live_timing_status

Obtenha o status da conexão com a API de Live Timing da F1

Parâmetros: Nenhum

Exemplo:

Check F1 Live Timing connection status

Retorna: Status atual da conexão e fluxos de dados ao vivo disponíveis.

🔍 get_api_status

Obtenha o status de todas as APIs de dados da F1 (Ergast, OpenF1, Live Timing)

Parâmetros: Nenhum

Exemplo:

Check status of all F1 data APIs and get recommendations

Retorna: Relatório abrangente de status das APIs com recomendações para fontes de dados ideais.

Tipos de Sessão

  • Practice 1, Practice 2, Practice 3
  • Qualifying, Sprint, Race

Abreviações dos Pilotos

  • HAM (Hamilton), VER (Verstappen), LEC (Leclerc)
  • RUS (Russell), NOR (Norris), PER (Perez)
  • E todos os outros pilotos de F1...

🔄 Atualizações

Para atualizar o F1 MCP Server:

# Pull latest changes
git pull origin main

# Install any new dependencies  
npm install

# Run tests to verify
npm test

# Restart Claude Desktop

📄 Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes.

🤝 Contribuindo

  1. Faça um fork do repositório
  2. Crie uma branch de funcionalidade (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

📞 Suporte

Para problemas e dúvidas:

  • Consulte a seção de solução de problemas acima
  • Revise os logs em logs/combined.log e logs/error.log
  • Abra uma issue no GitHub com mensagens de erro detalhadas

Pronto para revolucionar sua análise de F1 com o Claude! 🏁