Open Formula 1 MCP Server

Servidor MCP para recuperar y analizar carreras, autos, pilotos, vueltas, paradas en boxes y más de Fórmula 1 (F1).

GitHub
3
Prueba este MCPPatrocinado

Documentación

Open-F1-MCP-Server

Este proyecto implementa el servidor MCP para Open Formula 1

Para obtener información más detallada, consulta Implementación del servidor MCP de Open F1

Soy estudiante de secundaria y me gustaría saber si mi proyecto es apreciado y/o utilizado. Si te gusta o usas este servidor MCP, por favor dale una estrella en GitHub y compártelo con tus amigos, ¡gracias!

Arya Akman

¿Qué es Open Formula 1

Open Formula 1 es una API de código abierto que proporciona datos de Fórmula 1 en tiempo real e históricos.

La API ofrece una gran cantidad de información, incluyendo tiempos de vuelta, telemetría del coche, comunicaciones de radio y más. Ya sea que quieras crear paneles interactivos, profundizar en el análisis de carreras, o incluso desarrollar objetos conectados que se iluminen cada vez que tu piloto favorito toma la delantera, OpenF1 lo hace posible.


Herramientas (a partir de v1.2)

get_sessions:

Recupera sesiones de carreras de F1. Puede filtrar por año, país, circuito, tipo de sesión, etc. Devuelve detalles de la sesión incluyendo session_key, fecha, ubicación y tipo.

Parámetro	        Descripción
year		        Filtrar por año (p. ej., 2023, 2024).
country_name	    Filtrar por nombre de país (p. ej., 'Monaco', 'Italy').
circuit_short_name	Filtrar por nombre corto del circuito (p. ej., 'Monza', 'Monaco').
session_name    	Filtrar por nombre de sesión (p. ej., 'Race', 'Qualifying', 'Sprint').
session_key	    	Obtener una sesión específica por su session_key única.
date_start	    	Filtrar por fecha de inicio (formato ISO: YYYY-MM-DD). Admite filtros como >= y <=.
Otros filtros		session_type, location, country_code, meeting_key, gmt_offset

get_drivers:

Recupera información de pilotos. Puede obtener todos los pilotos actuales o filtrar por session_key para obtener los pilotos que participaron en una sesión específica. Devuelve detalles del piloto incluyendo nombre, número, equipo, país y URL de la foto de perfil.

Parámetro	    	Descripción
session_key	    	Opcional. Filtrar pilotos por session_key para obtener participantes de una sesión específica.
driver_number	   	Opcional. Filtrar por número de piloto (p. ej., 1, 44, 16).
team_name        	Opcional. Filtrar por nombre de equipo (p. ej., 'Red Bull Racing', 'Ferrari').

get_laps:

Recupera datos de vueltas para sesiones, pilotos y vueltas específicas. Devuelve información detallada de la vuelta incluyendo tiempo de vuelta, tiempos de sector, duración y posición.

Parámetro	    	Descripción
session_key	    	Requerido para obtener resultados significativos. Filtrar por la clave de sesión única.
driver_number	   	Opcional. Filtrar por número de piloto (p. ej., 1, 44, 16).
lap_number	    	Opcional. Filtrar por un número de vuelta específico.

get_pit_stops:

Recupera datos de paradas en boxes para sesiones específicas. Devuelve información detallada de la parada en boxes incluyendo duración, número de vuelta y tiempo.

Parámetro	    	Descripción
session_key	        Requerido para obtener resultados significativos. Filtrar por la clave de sesión única.
driver_number		Opcional. Filtrar por número de piloto (p. ej., 1, 44, 16).
pit_duration		Opcional. Límite superior para la duración de la parada en segundos (p. ej., 30.0 para paradas de menos de 30 segundos).

get_overtakes:

Recupera datos de adelantamientos que muestran cambios de posición entre pilotos. Un adelantamiento se refiere a un piloto (el piloto que adelanta) intercambiando posiciones con otro piloto (el piloto adelantado). Devuelve información detallada incluyendo los pilotos involucrados, el número de vuelta y el tiempo del evento.

Parámetro	                Descripción
session_key	    	        Requerido para obtener resultados significativos. Filtrar por la clave de sesión única.
overtaking_driver_number    Opcional. Filtrar por el número de piloto del piloto que realizó el adelantamiento (p. ej., 1, 44).
overtaken_driver_number		Opcional. Filtrar por el número de piloto del piloto que fue adelantado (p. ej., 16, 63).

Instrucciones de instalación:

1. Instalar dependencias:

bashpip install mcp httpx


2. Agregar/actualizar la configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "Open-F1": {
      "command": "python",
      "args": ["/path/to/OpenF1MCPServer.py"]
    }
  }
}

3. Reiniciar Claude Desktop y verificar la instalación

Ve a Claude Desktop -> Archivo -> Configuración -> Desarrollador

En el lado derecho de la pantalla, busca en Servidores MCP Locales y verifica

  • "Open-F1" aparece
  • El estado es "running" (resaltado con fondo azul)

Ejemplos de uso

Los siguientes ejemplos de indicaciones pueden proporcionar ideas sobre cómo utilizar este servidor MCP

  • Ejemplos de uso relacionados con sesiones (carrera)

    • "Muéstrame todas las sesiones de F1 de 2024"

    • "Obtén los detalles de la sesión de carrera para Mónaco 2023"

  • Ejemplos de uso relacionados con pilotos

    • "¿Quién condujo en la sesión 9158?" (usando un session_key)

    • "Muéstrame todos los pilotos de Ferrari de la carrera de Monza 2024"

  • Ejemplos de uso relacionados con información de vueltas

    • "Obtén los datos de la vuelta 10 para todos los pilotos en la carrera de Mónaco 2024"

    • "¿Cuál fue la vuelta más rápida de Max Verstappen en la última carrera?"

    • "Compara los tiempos de sector de la vuelta 1 entre los pilotos 1 y 44 en la sesión 9158"

  • Ejemplos de uso relacionados con paradas en boxes

    • "Muéstrame todas las paradas en boxes del Gran Premio de Singapur 2025"

    • "Obtén las paradas en boxes del piloto 1 en la sesión 9158"

    • "Encuentra todas las paradas en boxes de menos de 25 segundos en la última carrera"

    • "¿Qué piloto tuvo la parada en boxes más rápida en la carrera de Mónaco 2025?"

    • "Compara los tiempos de parada en boxes entre los pilotos de Red Bull y Ferrari"

    • "Muéstrame todas las paradas en boxes que tardaron más de 30 segundos en Singapur 2025"

  • Ejemplos de uso relacionados con adelantamientos

    • "Muéstrame todos los adelantamientos de la carrera de Mónaco 2024"

    • "¿Cuántas veces adelantó el piloto 1 a alguien en la sesión 9158?"

    • "¿Quién adelantó al piloto 44 en la última carrera?"

    • "Muéstrame todos los adelantamientos que involucran al piloto 16"

    • "¿Qué vuelta tuvo más adelantamientos en la sesión 9158?"

    • "Muéstrame todas las batallas entre los pilotos 1 y 16" (puedes usar ambos parámetros)


El servidor maneja las llamadas a la API de OpenF1 y devuelve datos formateados que Claude puede interpretar y presentarte