Formula One MCP Server

Formula One MCP Server

Este servidor Model Context Protocol (MCP) fornece acesso a dados e estatísticas da Fórmula 1 usando a biblioteca Python FastF1. Ele permite acessar calendários de corridas, informações de eventos, resultados de sessões, dados de pilotos, tempos de volta, telemetria e classificações de campeonato por meio de uma interface MCP limpa.

Recursos

• Obter calendários de corridas da Fórmula 1 para temporadas específicas
• Recuperar informações detalhadas sobre eventos de Grande Prêmio
• Obter resultados de sessões (Corrida, Classificação, Treino)
• Acessar informações e estatísticas de pilotos
• Analisar o desempenho dos pilotos com tempos de volta e dados de telemetria
• Comparar o desempenho de vários pilotos
• Obter classificações de campeonato para pilotos e construtores

Pré-requisitos

• Node.js 18 ou posterior
• Python 3.8 ou posterior
• biblioteca FastF1

Instalação

1. Instalar dependências do Python

pip install fastf1 pandas numpy

2. Instalar dependências do Node.js

cd f1-mcp-server
npm install

3. Compilar o código TypeScript

npm run build

4. Adicionar às configurações do MCP

Adicione o seguinte ao seu arquivo de configurações MCP do Cline (~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["/Users/rakeshgangwar/Documents/Cline/MCP/f1-mcp-server/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ferramentas Disponíveis

1. get_event_schedule

Obter calendário de corridas da Fórmula 1 para uma temporada específica.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)

2. get_event_info

Obter informações detalhadas sobre um Grande Prêmio específico da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• identifier (string): Nome do evento ou número da rodada (ex.: "Monaco" ou "7")

3. get_session_results

Obter resultados para uma sessão específica da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• event_identifier (string): Nome do evento ou número da rodada (ex.: "Monaco" ou "7")
• session_name (string): Nome da sessão (ex.: "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")

4. get_driver_info

Obter informações sobre um piloto específico da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• event_identifier (string): Nome do evento ou número da rodada (ex.: "Monaco" ou "7")
• session_name (string): Nome da sessão (ex.: "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• driver_identifier (string): Identificador do piloto (número, código ou nome; ex.: "44", "HAM", "Hamilton")

5. analyze_driver_performance

Analisar o desempenho de um piloto em uma sessão da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• event_identifier (string): Nome do evento ou número da rodada (ex.: "Monaco" ou "7")
• session_name (string): Nome da sessão (ex.: "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• driver_identifier (string): Identificador do piloto (número, código ou nome; ex.: "44", "HAM", "Hamilton")

6. compare_drivers

Comparar o desempenho entre vários pilotos da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• event_identifier (string): Nome do evento ou número da rodada (ex.: "Monaco" ou "7")
• session_name (string): Nome da sessão (ex.: "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• drivers (string): Lista separada por vírgulas de códigos de pilotos (ex.: "HAM,VER,LEC")

7. get_telemetry

Obter dados de telemetria para uma volta específica da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• event_identifier (string): Nome do evento ou número da rodada (ex.: "Monaco" ou "7")
• session_name (string): Nome da sessão (ex.: "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• driver_identifier (string): Identificador do piloto (número, código ou nome; ex.: "44", "HAM", "Hamilton")
• lap_number (número, opcional): Número da volta (obtém a volta mais rápida se não for fornecido)

8. get_championship_standings

Obter classificações de campeonato da Fórmula 1.

Parâmetros:

• year (número): Ano da temporada (ex.: 2023)
• round_num (número, opcional): Número da rodada (obtém as classificações mais recentes se não for fornecido)

Exemplo de Uso

Depois que o servidor for adicionado às suas configurações MCP e estiver em execução, você pode usar essas ferramentas com o Cline para acessar dados da Fórmula 1.

Exemplos de consultas:

• "Mostre-me o calendário de corridas da Fórmula 1 de 2023"
• "Obtenha os resultados do Grande Prêmio de Mônaco de 2022"
• "Compare o desempenho de Hamilton e Verstappen no Grande Prêmio Britânico de 2021"
• "Mostre-me os dados de telemetria da volta mais rápida de Leclerc na classificação do Grande Prêmio da Itália de 2023"
• "Quais são as classificações atuais do campeonato de F1?"

Fonte de Dados

Este servidor usa a biblioteca Python FastF1, que fornece acesso a dados oficiais de tempo da Fórmula 1, telemetria de carros e resultados de sessões.

Licença

MIT