Formula One MCP Server (Python)

MIT License
  • Linux
  • Apple

Integrations

  • Enables access to Formula One racing data from a GitHub repository, with the README mentioning the project was inspired by another GitHub repository.

  • Utilizes NumPy as a dependency for working with numerical data in Formula One racing statistics and telemetry analysis.

  • Leverages pandas for data manipulation and analysis of Formula One data, including race results, telemetry, and driver statistics.

Servidor MCP de Fórmula Uno

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos de carreras de Fórmula Uno. Este paquete expone diversas herramientas para consultar datos de F1, incluidos calendarios de eventos, información de los pilotos, datos de telemetría y resultados de carreras.

Características

  • Calendario de eventos : acceda al calendario completo de carreras de F1 para cualquier temporada
  • Información del evento : datos detallados sobre eventos específicos del Gran Premio
  • Resultados de la sesión : Resultados completos de carreras, sesiones de clasificación, sprints y sesiones de práctica.
  • Información del conductor : acceda a los detalles del conductor para sesiones específicas
  • Análisis de rendimiento : analice el rendimiento de un conductor con estadísticas de tiempos de vuelta
  • Comparación de pilotos : compare el rendimiento de varios pilotos en la misma sesión
  • Datos de telemetría : acceda a telemetría detallada para vueltas específicas
  • Clasificación del campeonato : vea la clasificación de pilotos y constructores de cualquier temporada

Instalación

En un proyecto de Python administrado uv , agregue dependencias mediante:

uv add f1-mcp-server

Alternativamente, para proyectos que utilizan pip para dependencias:

pip install f1-mcp-server

Para ejecutar el servidor dentro de su proyecto:

uv run f1-mcp-server

O ejecutarlo globalmente en un entorno aislado:

uvx f1-mcp-server

Para instalar directamente desde la fuente:

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git cd f1-mcp-server pip install -e .

Uso

Línea de comandos

El servidor se puede ejecutar en dos modos:

Modo de E/S estándar (predeterminado):

uvx run f1-mcp-server

Modo de transporte SSE (para aplicaciones web):

uvx f1-mcp-server --transport sse --port 8000

API de Python

from f1_mcp_server import main # Run the server with default settings main() # Or with SSE transport settings main(port=9000, transport="sse")

Documentación de la API

El servidor expone las siguientes herramientas a través de MCP:

Nombre de la herramientaDescripción
get_event_scheduleObtenga el calendario de carreras de Fórmula Uno para una temporada específica
get_event_infoObtenga información detallada sobre un Gran Premio de Fórmula 1 específico
get_session_resultsObtenga resultados para una sesión específica de Fórmula Uno
get_driver_infoObtenga información sobre un piloto de Fórmula 1 específico
analyze_driver_performanceAnalizar el rendimiento de un piloto en una sesión de Fórmula Uno
compare_driversComparar el rendimiento entre varios pilotos de Fórmula Uno
get_telemetryObtener datos de telemetría para una vuelta específica de Fórmula Uno
get_championship_standingsObtenga la clasificación del campeonato de Fórmula Uno

Consulte la documentación de FastF1 para obtener información detallada sobre los datos subyacentes: Documentación de FastF1

Dependencias

  • anyio (>=4.9.0)
  • haga clic (>=8.1.8)
  • fastf1 (>=3.5.3)
  • mcp (>=1.6.0)
  • numpy (>=2.2.4)
  • pandas (>=2.2.3)
  • uvicornio (>=0.34.0)

Desarrollo

Configurar el entorno de desarrollo

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git cd f1-mcp-server uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e ".[dev]"

Calidad del código

# Run linting uv run ruff check . # Run formatting check uv run ruff format --check . # Run security checks uv run bandit -r src/

Pautas de contribución

  1. Bifurcar el repositorio
  2. Crear una rama de características: git checkout -b feature-name
  3. Confirme sus cambios: git commit -am 'Add some feature'
  4. Empujar a la rama: git push origin feature-name
  5. Enviar una solicitud de extracción

Licencia

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

Autores

  • De máquina a máquina

Expresiones de gratitud

Este proyecto aprovecha FastF1 , un excelente paquete de Python para acceder a datos de Fórmula 1. Agradecemos a sus mantenedores y colaboradores.

Este proyecto se inspiró en rakeshgangwar/f1-mcp-server , escrito en TypeScript. El módulo f1_data.py se adaptó principalmente de su código fuente.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos de carreras de Fórmula 1 mediante la biblioteca FastF1 de Python. Inspirado en un servidor TypeScript existente, ofrece funcionalidades similares a las de los datos de F1 de forma nativa en Python a través de FastF1.

  1. Features
    1. Installation
      1. Usage
        1. Command Line
        2. Python API
      2. API Documentation
        1. Dependencies
          1. Development
            1. Setup Development Environment
            2. Code Quality
            3. Contribution Guidelines
          2. License
            1. Authors
              1. Acknowledgements
                ID: qu9jvw5zsv