Skip to main content
Glama
Formula One MCP Server (Python)

Formula One MCP Server (Python)

Servidor MCP de Fórmula Uno

Versión de PyPI Versiones de Python Licencia: MIT insignia de herrería

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

Related MCP server: Formula One MCP Server

Instalación

Instalación mediante herrería

Para instalar f1-mcp-server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @Machine-To-Machine/f1-mcp-server --client claude

Instalación manual

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 herramienta

Descripción

get_event_schedule

Obtenga el calendario de carreras de Fórmula Uno para una temporada específica

get_event_info

Obtenga información detallada sobre un Gran Premio de Fórmula 1 específico

get_session_results

Obtenga resultados para una sesión específica de Fórmula Uno

get_driver_info

Obtenga información sobre un piloto de Fórmula 1 específico

analyze_driver_performance

Analizar el rendimiento de un piloto en una sesión de Fórmula Uno

compare_drivers

Comparar el rendimiento entre varios pilotos de Fórmula Uno

get_telemetry

Obtener datos de telemetría para una vuelta específica de Fórmula Uno

get_championship_standings

Obtenga 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.

Available Tools

8 tools
analyze_driver_performanceC

Analyze a driver's performance in a Formula One session

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required).

compare_driversB

Compare performance between multiple Formula One drivers

Inputs: year (required), event_identifier (required), session_name (required), drivers (required).

get_championship_standingsC

Get Formula One championship standings

Inputs: year (required), round_num.

get_driver_infoC

Get information about a specific Formula One driver

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required).

get_event_infoB

Get detailed information about a specific Formula One Grand Prix

Inputs: year (required), identifier (required).

get_event_scheduleA

Get Formula One race calendar for a specific season

Inputs: year (required).

get_session_resultsC

Get results for a specific Formula One session

Inputs: year (required), event_identifier (required), session_name (required).

get_telemetryC

Get telemetry data for a specific Formula One lap

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    All 8 tools target distinct aspects of Formula One data—drivers, events, sessions, championships, and telemetry—with no overlapping functionality. Each has a clear, non-redundant purpose.

    Naming Consistency5/5

    Every tool uses a consistent verb_noun pattern with lowercase and underscores (e.g., get_driver_info, analyze_driver_performance). The naming is predictable and adheres to a single convention.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its domain. It covers essential F1 operations without being too sparse or overly granular, making it ideal for most common queries without excessive complexity.

    Completeness4/5

    The tool set covers major areas: driver info, performance analysis, comparisons, standings, event details, schedule, session results, and telemetry. One minor gap is lack of team/constructor info, but the surface is otherwise comprehensive for a dedicated F1 server.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical Formula 1 racing data through the Model Context Protocol, offering access to timing data, driver stats, race results, telemetry, and more.
      14
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that provides comprehensive Formula One racing data, enabling access to event schedules, driver information, telemetry data, race results, and performance analytics through natural language queries.
      8
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Formula 1 data via the FastF1 library. Ask Claude (or any MCP-compatible client) about race results, lap times, telemetry, standings, pit stops, and qualifying — with historical data back to 1950 via the Ergast API.
      21
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A local MCP server that gives Claude (or any MCP-compatible AI client) access to Formula 1 race data. Load any session from 2018 onwards, ask questions in natural language, and get answers backed by real telemetry, timing, and strategy data.
      17
      1
      MIT