Formula One MCP Server (Python)
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
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 claudeInstalación manual
En un proyecto de Python administrado uv , agregue dependencias mediante:
uv add f1-mcp-serverAlternativamente, para proyectos que utilizan pip para dependencias:
pip install f1-mcp-serverPara ejecutar el servidor dentro de su proyecto:
uv run f1-mcp-serverO ejecutarlo globalmente en un entorno aislado:
uvx f1-mcp-serverPara 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-serverModo de transporte SSE (para aplicaciones web):
uvx f1-mcp-server --transport sse --port 8000API 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 |
| Obtenga el calendario de carreras de Fórmula Uno para una temporada específica |
| Obtenga información detallada sobre un Gran Premio de Fórmula 1 específico |
| Obtenga resultados para una sesión específica de Fórmula Uno |
| Obtenga información sobre un piloto de Fórmula 1 específico |
| Analizar el rendimiento de un piloto en una sesión de Fórmula Uno |
| Comparar el rendimiento entre varios pilotos de Fórmula Uno |
| Obtener datos de telemetría para una vuelta específica de Fórmula Uno |
| 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
Bifurcar el repositorio
Crear una rama de características:
git checkout -b feature-nameConfirme sus cambios:
git commit -am 'Add some feature'Empujar a la rama:
git push origin feature-nameEnviar 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 toolsanalyze_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Primarily to be used as a template repository for developing MCP servers with FastMCP in Python, P…
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A simple MCP server built with FastMCP and python
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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.14MIT
- AlicenseAqualityDmaintenanceA 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.81MIT
- AlicenseAqualityCmaintenanceMCP 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.21MIT
- AlicenseAqualityDmaintenanceA 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.171MIT