Formula One MCP Server

Formula One MCP Server

Este servidor de Protocolo de Contexto de Modelo (MCP) proporciona acceso a datos y estadísticas de Formula One utilizando la biblioteca FastF1 de Python. Le permite acceder a calendarios de carreras, información de eventos, resultados de sesiones, datos de pilotos, tiempos de vuelta, telemetría y clasificaciones de campeonato a través de una interfaz MCP limpia.

Características

• Obtener calendarios de carreras de Formula One para temporadas específicas.
• Recuperar información detallada sobre eventos de Grand Prix.
• Obtener resultados de sesiones (Carrera, Clasificación, Práctica).
• Acceder a información y estadísticas de pilotos.
• Analizar el rendimiento de los pilotos con tiempos de vuelta y datos de telemetría.
• Comparar el rendimiento de múltiples pilotos.
• Obtener clasificaciones de campeonato para pilotos y constructores.

Requisitos previos

• Node.js 18 o posterior
• Python 3.8 o posterior
• Biblioteca FastF1

Instalación

1. Instalar dependencias de Python

pip install fastf1 pandas numpy

2. Instalar dependencias de Node.js

cd f1-mcp-server
npm install

3. Compilar el código TypeScript

npm run build

4. Añadir a la configuración de MCP

Añade lo siguiente a tu archivo de configuración de MCP de 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": []
    }
  }
}

Herramientas disponibles

1. get_event_schedule

Obtener el calendario de carreras de Formula One para una temporada específica.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)

2. get_event_info

Obtener información detallada sobre un Gran Premio específico de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• identifier (cadena): Nombre del evento o número de ronda (p. ej., "Monaco" o "7")

3. get_session_results

Obtener resultados de una sesión específica de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• event_identifier (cadena): Nombre del evento o número de ronda (p. ej., "Monaco" o "7")
• session_name (cadena): Nombre de la sesión (p. ej., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")

4. get_driver_info

Obtener información sobre un piloto específico de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• event_identifier (cadena): Nombre del evento o número de ronda (p. ej., "Monaco" o "7")
• session_name (cadena): Nombre de la sesión (p. ej., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• driver_identifier (cadena): Identificador del piloto (número, código o nombre; p. ej., "44", "HAM", "Hamilton")

5. analyze_driver_performance

Analizar el rendimiento de un piloto en una sesión de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• event_identifier (cadena): Nombre del evento o número de ronda (p. ej., "Monaco" o "7")
• session_name (cadena): Nombre de la sesión (p. ej., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• driver_identifier (cadena): Identificador del piloto (número, código o nombre; p. ej., "44", "HAM", "Hamilton")

6. compare_drivers

Comparar el rendimiento entre múltiples pilotos de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• event_identifier (cadena): Nombre del evento o número de ronda (p. ej., "Monaco" o "7")
• session_name (cadena): Nombre de la sesión (p. ej., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• drivers (cadena): Lista de códigos de pilotos separados por comas (p. ej., "HAM,VER,LEC")

7. get_telemetry

Obtener datos de telemetría para una vuelta específica de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• event_identifier (cadena): Nombre del evento o número de ronda (p. ej., "Monaco" o "7")
• session_name (cadena): Nombre de la sesión (p. ej., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
• driver_identifier (cadena): Identificador del piloto (número, código o nombre; p. ej., "44", "HAM", "Hamilton")
• lap_number (número, opcional): Número de vuelta (obtiene la vuelta más rápida si no se proporciona)

8. get_championship_standings

Obtener clasificaciones de campeonato de Formula One.

Parámetros:

• year (número): Año de la temporada (p. ej., 2023)
• round_num (número, opcional): Número de ronda (obtiene las clasificaciones más recientes si no se proporciona)

Ejemplo de uso

Una vez que el servidor se añade a tu configuración de MCP y está en ejecución, puedes usar estas herramientas con Cline para acceder a datos de Formula One.

Consultas de ejemplo:

• "Muéstrame el calendario de carreras de Formula One 2023"
• "Obtén los resultados del Gran Premio de Mónaco 2022"
• "Compara el rendimiento de Hamilton y Verstappen en el Gran Premio Británico de 2021"
• "Muéstrame los datos de telemetría de la vuelta más rápida de Leclerc en la clasificación del Gran Premio de Italia 2023"
• "¿Cuáles son las clasificaciones actuales del campeonato de F1?"

Fuente de datos

Este servidor utiliza la biblioteca FastF1 de Python, que proporciona acceso a datos oficiales de tiempos de Fórmula 1, telemetría de coches y resultados de sesiones.

Licencia

MIT