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: Formula1 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:

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.