¡El servidor MCP de Fórmula 1! 🏎️💨

Un servidor MCP de Fórmula 1 basado en TypeScript que te trae la emoción de los datos históricos y en tiempo real de las carreras de F1 directamente a tu alcance mediante el Protocolo de Contexto de Modelo. ¡Más rápido que Verstappen en una vuelta rápida! (Bueno, quizá no tan rápido, ¡pero lo intenta!)

Recursos

• Acceda a los datos de la sesión de F1 a través de URI estandarizados

• Datos de telemetría en tiempo real

• Información histórica de la carrera

• Clasificación de pilotos y constructores

• Datos meteorológicos

• Información del circuito

Empezando

Instalación rápida a través de Smithery

Para instalar el servidor MCP de Fórmula 1 automáticamente a través de Smithery:

npx -y @smithery/cli install @Panth1823/formula1-mcp --client claude

Instalación manual

1. Clonar el repositorio:

git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp

2. Instalar:

npm install

3. Construir:

npm run build

Related MCP server: Formula One MCP Server (Python)

Configuración

Agregue a su configuración de cliente MCP:

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["<path-to-your-cloned-repo>/build/index.js"],
      "cwd": "<path-to-your-cloned-repo>",
      "enabled": true
    }
  }
}

Ubicaciones de configuración:

• Ventanas: %APPDATA%\.cursor\mcp.json

• MacOS: ~/.cursor/mcp.json

• Linux: ~/.config/.cursor/mcp.json

Herramientas disponibles

1. getLiveTimingData

Obtenga datos de cronometraje en tiempo real para la sesión actual.

Parámetros:

• No se requiere ninguno

2. getCurrentSessionStatus sesión actual

Obtener información sobre el estado de la sesión actual.

Parámetros:

• No se requiere ninguno

3. getDriverInfo

Obtenga información sobre un controlador específico.

Parámetros:

• driverId (cadena): identificador del conductor (p. ej., "max_verstappen", "lewis_hamilton")

4. getHistoricalSessions

Encuentre claves de sesión para eventos históricos.

Parámetros:

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

• circuit_short_name (cadena, opcional): Nombre del circuito (p. ej., "monza", "spa")

• country_name (cadena, opcional): nombre del país (p. ej., "Italia", "Bélgica")

• session_name (cadena, opcional): Tipo de sesión (p. ej., "Carrera", "Clasificación")

5. getHistoricRaceResults

Obtenga los resultados de la carrera de una carrera histórica específica.

Parámetros:

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

• round (número): Número de carrera (p. ej., 1, 2, 3)

6. getDriverStandings

Obtenga la clasificación del campeonato de pilotos.

Parámetros:

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

7. getConstructorStandings

Obtenga la clasificación del campeonato de constructores.

Parámetros:

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

8. getLapTimes

Obtenga los tiempos de vuelta de un conductor específico.

Parámetros:

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

• round (número): Número de carrera (p. ej., 1, 2, 3)

• driverId (cadena): identificador del conductor (p. ej., "max_verstappen", "lewis_hamilton")

9. getWeatherData

Obtener datos meteorológicos para una sesión.

Parámetros:

• sessionKey (cadena, opcional): identificador de sesión

10. getCarData

Obtenga datos detallados de telemetría del automóvil.

Parámetros:

• driverNumber (cadena): Número de coche del conductor (p. ej., "44", "33")

• sessionKey (cadena, opcional): identificador de sesión

• filters (cadena, opcional): filtros de datos

11. getPitStopData

Obtenga información sobre las paradas en boxes.

Parámetros:

• driverNumber (cadena, opcional): Número de coche del conductor

• sessionKey (cadena, opcional): identificador de sesión

12. getTeamRadio

Obtener comunicaciones por radio del equipo.

Parámetros:

• driverNumber (cadena, opcional): Número de coche del conductor

• sessionKey (cadena, opcional): identificador de sesión

13. getRaceControlMessages

Recibir mensajes de control de carrera.

Parámetros:

• sessionKey (cadena, opcional): identificador de sesión

14. getRaceCalendar

Obtenga el calendario de carreras de F1.

Parámetros:

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

15. getCircuitInfo

Obtenga información detallada del circuito.

Parámetros:

• circuitId (cadena): identificador del circuito (p. ej., "monza", "spa")

16. getSeasonList

Obtenga una lista de las temporadas de F1 disponibles.

Parámetros:

• limit (número, opcional): Número de temporadas a regresar

17. getQualifyingResults

Obtenga los resultados de la sesión de clasificación.

Parámetros:

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

• round (número): Número de carrera (p. ej., 1, 2, 3)

18. getDriverInformation

Obtenga información detallada del conductor desde la API de Ergast.

Parámetros:

• driverId (cadena): identificador del conductor (p. ej., "max_verstappen", "lewis_hamilton")

19. getConstructorInformation

Obtenga información detallada del constructor desde la API de Ergast.

Parámetros:

• constructorId (cadena): identificador del constructor (p. ej., "red_bull", "mercedes")

20. clearCache

Borre la memoria caché local de los datos de F1.

Parámetros:

• No se requiere ninguno

Fuentes de datos

• Datos en vivo: API de cronometraje en vivo de F1 (OpenF1)

• Historial: API de Ergast (FastF1)

Ejemplos

• Ver resultados del GP de Mónaco 2023

• "Obtener la clasificación actual"

• El tiempo en Silverstone

• Los tiempos de vuelta de Hamilton

• Mostrar calendario 2024

• Información de Verstappen

• Clasificación del GP de Japón

Depurar

Utilice MCP Inspector para la depuración.

Ayuda

• ¿Errores? Reportar aquí

• ¿Preguntas? Abra un problema

• ¿Quieres ayudar? Envía una solicitud de colaboración.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.