F1 MCP Server

Proporciona análisis avanzado de datos de Fórmula 1, incluyendo telemetría en tiempo real, rendimiento de neumáticos, predicción meteorológica y simulación de estrategia de carrera.

GitHub
6

Documentación

F1 MCP Server

Servidor MCP Avanzado de Análisis de Datos de Fórmula 1 - Telemetría en tiempo real, análisis de rendimiento de neumáticos y simulación de estrategia de carrera para Claude

Un sofisticado servidor de Model Context Protocol (MCP) que proporciona a Claude capacidades avanzadas de análisis de Fórmula 1, incluyendo procesamiento de telemetría en tiempo real, modelado de degradación de neumáticos, análisis de impacto meteorológico y simulación de estrategia de carrera Monte Carlo.

🏎️ Características

12 Potentes Herramientas de Análisis F1

Herramientas de Análisis Principal (8)

  • Análisis de Datos de Sesión - Datos completos del fin de semana de carrera con telemetría y clima
  • Análisis de Rendimiento de Neumáticos - Modelado avanzado de degradación con análisis térmico
  • Análisis de Tiempos de Vuelta - Análisis corregido por combustible con desglose de 25 mini-sectores
  • Predicción de Impacto Meteorológico - Pronóstico LSTM/CNN con recomendaciones estratégicas
  • Simulación de Estrategia de Carrera - Simulación Monte Carlo con 300M-1B+ permutaciones
  • Análisis de Rendimiento del Piloto - Extracción de habilidades separando rendimiento del coche vs. piloto
  • Procesamiento de Telemetría en Tiempo Real - Análisis avanzado de señales con detección de anomalías
  • Análisis de Rendimiento por Sector - Análisis de 25 mini-sectores con correlación de curvatura de pista

Herramientas de Datos en Vivo 2025 (4)

  • Información de la Temporada Actual - Datos de temporada F1 en vivo con estado en tiempo real
  • Calendario de Carreras - Calendario F1 completo para las temporadas 2018-2025
  • Conexión de Cronometraje en Vivo - Integración con la API oficial de cronometraje en vivo de F1
  • Monitoreo de Estado de API - Estado en tiempo real de todas las fuentes de datos F1

Capacidades Avanzadas de Análisis

  • Modelos Matemáticos: Física sofisticada de degradación de neumáticos con factores térmicos, mecánicos y químicos
  • Procesamiento de Señales: FFT, análisis de wavelets y filtrado de Kalman para datos de telemetría
  • Modelado Meteorológico: Pronóstico por conjuntos con modelos híbridos LSTM/CNN
  • Optimización de Estrategia: Simulación Monte Carlo con resultados probabilísticos y análisis de riesgo
  • Extracción de Rendimiento: Análisis de habilidades del piloto con división de rendimiento coche/piloto 88%/12%

📋 Requisitos Previos

  • Node.js 18.0.0 o superior
  • npm (incluido con Node.js)
  • Claude Desktop aplicación

🚀 Instalación

Paso 1: Clonar y Configurar el Servidor

# Clone the repository
git clone https://github.com/stagsz/F1-MCP-Server
cd F1-mcp-server

# Install dependencies
npm install

# Verify installation
npm test

Paso 2: Configurar Claude Desktop

Debe añadir este servidor MCP a su archivo de configuración de Claude Desktop.

Windows

Edite el archivo en: %APPDATA%\Claude\claude_desktop_config.json

macOS

Edite el archivo en: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux

Edite el archivo en: ~/.config/Claude/claude_desktop_config.json

Paso 3: Añadir Configuración del Servidor

Añada la siguiente configuración a su archivo claude_desktop_config.json:

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "node",
      "args": ["path/to/F1-mcp-server/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Importante: Reemplace path/to/F1-mcp-server/index.js con la ruta absoluta a su directorio de F1-mcp-server.

Ejemplos de configuración:

Windows:

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\F1-mcp-server\\index.js"]
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "node", 
      "args": ["/home/username/F1-mcp-server/index.js"]
    }
  }
}

Paso 4: Reiniciar Claude Desktop

Después de guardar el archivo de configuración, cierre y reinicie completamente Claude Desktop para que los cambios surtan efecto.

🔧 Verificación

Una vez que Claude Desktop se reinicie, puede verificar que el F1 MCP Server está funcionando preguntándole a Claude:

Can you analyze tire performance for a Formula 1 race?

Claude ahora debería tener acceso a todas las capacidades de análisis F1 y utilizará el servidor MCP para proporcionar análisis detallados.

📚 Ejemplos de Uso

Análisis de Rendimiento de Neumáticos

Analyze tire degradation for Lewis Hamilton using medium compound tires in the 2024 Monaco Grand Prix race session.

Simulación de Estrategia de Carrera

Run a Monte Carlo simulation comparing one-stop vs two-stop strategies for Max Verstappen at Silverstone 2024.

Análisis de Impacto Meteorológico

Predict weather impact for the next 3 hours during qualifying at Spa-Francorchamps and recommend tire strategy.

Análisis de Rendimiento del Piloto

Analyze Charles Leclerc's driving performance and extract his skill level compared to car performance at Monza 2024.

Análisis de Tiempos de Vuelta

Perform fuel-corrected lap time analysis for George Russell in Practice 2, including mini-sector breakdown.

Telemetría en Tiempo Real

Process real-time telemetry data for Fernando Alonso focusing on speed, throttle, and brake channels.

🛠️ Desarrollo

Pruebas

# Run test suite
npm test

# Run tests with coverage
npm run test -- --coverage

# Check syntax
node --check index.js

Modo de Desarrollo

# Start with auto-reload
npm run dev

# Check logs
tail -f logs/combined.log

Depuración

# Enable debug logging
export LOG_LEVEL=debug
npm start

📊 Especificaciones Técnicas

Procesamiento de Datos

  • Volumen de Telemetría: Simulación de 1.1M+ puntos de datos por segundo
  • Frecuencia de Muestreo: Simulación de 100Hz
  • Monte Carlo: 300M a 1B+ permutaciones por carrera
  • Procesamiento de Señales: FFT, análisis de wavelets, filtrado de Kalman

Modelos Matemáticos

  • Degradación de Neumáticos: Factores térmicos, mecánicos y químicos
  • Pronóstico Meteorológico: Modelos de conjunto LSTM/CNN
  • Análisis del Piloto: División de rendimiento coche/piloto 88%/12%
  • Optimización de Estrategia: Modelado de resultados probabilísticos

Datos F1 Compatibles e Integración en Vivo

  • Años: 2018-2025 (incluyendo la temporada 2025 actual)
  • Sesiones: Práctica 1-3, Clasificación, Sprint, Carrera
  • Fuentes de Datos: F1 Live Timing → API OpenF1 → API Ergast → Simulación Avanzada
  • Datos en Vivo: Telemetría en tiempo real durante sesiones F1 activas
  • Compuestos de Neumáticos: C1-C6, Blando/Medio/Duro, Intermedios, Lluvia
  • Clima: Condiciones en vivo, temperatura, humedad, probabilidad de lluvia, viento
  • Telemetría: Velocidad, acelerador, freno, DRS, marcha, RPM, temperaturas de neumáticos, coordenadas GPS

🚨 Solución de Problemas

El Servidor No Se Inicia

# Check Node.js version
node --version  # Should be 18.0.0+

# Verify dependencies
npm install

# Check syntax
node --check index.js

Claude No Puede Encontrar el Servidor

  1. Verifique que la ruta en claude_desktop_config.json sea absoluta y correcta
  2. Asegúrese de que Claude Desktop se reinició completamente después de los cambios de configuración
  3. Compruebe que Node.js esté en el PATH de su sistema

Problemas de Permisos (macOS/Linux)

# Make index.js executable
chmod +x index.js

# Check file permissions
ls -la index.js

Problemas de Dependencias

# Clear cache and reinstall
rm -rf node_modules package-lock.json
npm install

📖 Documentación Completa de Herramientas

Herramientas de Análisis Principal

🏁 get_session_data

Obtenga datos completos de sesión F1 incluyendo telemetría, cronometraje y clima

Parámetros:

  • year (obligatorio): Año de la carrera (2018-2025)
  • round (obligatorio): Número de ronda de la carrera (1-24)
  • session (obligatorio): Tipo de sesión
    • Practice 1, Practice 2, Practice 3
    • Qualifying, Sprint, Race

Ejemplo:

Get session data for 2024 Monaco Grand Prix qualifying

Devuelve: Resumen completo de la sesión con tiempos de vuelta, condiciones climáticas, uso de neumáticos y resúmenes de telemetría.

🏎️ analyze_tire_performance

Análisis avanzado de rendimiento de neumáticos con modelado de degradación e información estratégica

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • session (obligatorio): Tipo de sesión
  • driver (opcional): Abreviatura del piloto (HAM, VER, LEC, etc.)
  • compound (opcional): Compuesto de neumático (SOFT, MEDIUM, HARD)

Ejemplo:

Analyze tire degradation for Lewis Hamilton using medium compound tires in the 2024 Monaco Grand Prix race session

Devuelve: Análisis detallado de neumáticos incluyendo:

  • Curvas de degradación con modelado térmico
  • Patrones de pérdida de agarre y duraciones óptimas de stint
  • Recomendaciones estratégicas para cambios de neumáticos
  • Comparación de rendimiento entre compuestos

⏱️ analyze_lap_times

Análisis sofisticado de tiempos de vuelta con corrección de combustible y desglose de mini-sectores

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • session (obligatorio): Tipo de sesión
  • driver (opcional): Abreviatura del piloto
  • fuel_corrected (opcional): Aplicar corrección de combustible (por defecto: true)

Ejemplo:

Perform fuel-corrected lap time analysis for George Russell in Practice 2, including mini-sector breakdown

Devuelve: Análisis avanzado de tiempos de vuelta con:

  • Tiempos de vuelta corregidos por combustible y análisis de ritmo
  • Desglose de rendimiento en 25 mini-sectores
  • Evolución de la pista y progresión de la sesión
  • Análisis comparativo frente al resto del campo

🌦️ predict_weather_impact

Análisis y predicción de impacto meteorológico para estrategia de carrera

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • session (obligatorio): Tipo de sesión
  • forecast_hours (opcional): Ventana de pronóstico en horas (por defecto: 3)

Ejemplo:

Predict weather impact for the next 3 hours during qualifying at Spa-Francorchamps and recommend tire strategy

Devuelve: Análisis meteorológico completo incluyendo:

  • Pronóstico meteorológico por conjunto LSTM/CNN
  • Predicciones de probabilidad e intensidad de lluvia
  • Recomendaciones estratégicas para elección de neumáticos
  • Ventanas de tiempo para condiciones óptimas de pista

🎯 simulate_race_strategy

Simulación de estrategia de carrera Monte Carlo con resultados probabilísticos

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • driver (obligatorio): Abreviatura del piloto
  • strategy_options (opcional): Matriz de estrategias (p. ej., ["soft-medium", "medium-hard"])
  • simulations (opcional): Número de simulaciones Monte Carlo (por defecto: 10,000)

Ejemplo:

Run a Monte Carlo simulation comparing one-stop vs two-stop strategies for Max Verstappen at Silverstone 2024

Devuelve: Análisis detallado de estrategia con:

  • Simulación Monte Carlo con 300M-1B+ permutaciones
  • Resultados probabilísticos y tasas de éxito
  • Análisis de riesgo y ventanas óptimas de pit stop
  • Recomendaciones de estrategia con intervalos de confianza

👨‍💼 analyze_driver_performance

Extracción de rendimiento del piloto separando la habilidad del rendimiento del coche

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • session (obligatorio): Tipo de sesión
  • driver (obligatorio): Abreviatura del piloto
  • comparison_driver (opcional): Piloto con el que comparar

Ejemplo:

Analyze Charles Leclerc's driving performance and extract his skill level compared to car performance at Monza 2024

Devuelve: Análisis avanzado del piloto incluyendo:

  • Extracción de habilidades con división de rendimiento coche/piloto 88%/12%
  • Análisis de estilo de conducción y métricas de rendimiento
  • Comparación con el compañero de equipo o piloto especificado
  • Identificación de fortalezas y áreas de mejora

📡 get_real_time_telemetry

Procesamiento de datos de telemetría en tiempo real con análisis avanzado de señales

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • session (obligatorio): Tipo de sesión
  • driver (obligatorio): Abreviatura del piloto
  • lap (opcional): Número de vuelta específico
  • channels (opcional): Matriz de canales de telemetría a analizar

Canales Disponibles:

  • Speed, Throttle, Brake, DRS, Gear, RPM
  • TireTemp, BrakeTemp, GPS, EngineTemp

Ejemplo:

Process real-time telemetry data for Fernando Alonso focusing on speed, throttle, and brake channels

Devuelve: Análisis completo de telemetría con:

  • Procesamiento de datos de alta frecuencia (simulación de 100Hz)
  • FFT, análisis de wavelets y filtrado de Kalman
  • Detección de anomalías y optimización de rendimiento
  • Análisis comparativo y recomendaciones de configuración

🏁 analyze_sector_performance

Análisis de 25 mini-sectores con correlación de curvatura de pista

Parámetros:

  • year (obligatorio): Año de la carrera
  • round (obligatorio): Número de ronda de la carrera
  • session (obligatorio): Tipo de sesión
  • driver (opcional): Abreviatura del piloto

Ejemplo:

Analyze sector performance for all drivers in 2024 Hungarian Grand Prix qualifying with track curvature correlation

Devuelve: Análisis detallado de sectores incluyendo:

  • Desglose de rendimiento en 25 mini-sectores
  • Correlación de curvatura y elevación de la pista
  • Análisis de velocidad máxima y rendimiento en curvas
  • Recomendaciones de configuración y conducción específicas por sector

Herramientas de Datos en Vivo 2025

📅 get_current_season_info

Obtenga información de la temporada F1 actual incluyendo disponibilidad de datos en vivo

Parámetros:

  • include_live_status (opcional): Incluir estado de sesión en vivo (por defecto: true)

Ejemplo:

Get current F1 season information with live data status

Devuelve: Resumen de la temporada actual con estado de disponibilidad de datos en vivo.

🗓️ get_race_schedule

Obtenga el calendario de carreras F1 para cualquier año incluyendo 2025

Parámetros:

  • year (obligatorio): Año de la carrera (2018-2025)

Ejemplo:

Get the complete 2025 F1 race schedule

Devuelve: Calendario completo de carreras con fechas, sedes y horarios de sesiones.

🔴 connect_live_timing

Conéctese a la API oficial de cronometraje en vivo de F1 para datos en tiempo real

Parámetros: Ninguno

Ejemplo:

Connect to F1 Official Live Timing API

Devuelve: Estado de la conexión de cronometraje en vivo y fuentes de datos en tiempo real disponibles.

📊 get_live_timing_status

Obtenga el estado de la conexión a la API de cronometraje en vivo de F1

Parámetros: Ninguno

Ejemplo:

Check F1 Live Timing connection status

Devuelve: Estado actual de la conexión y flujos de datos en vivo disponibles.

🔍 get_api_status

Obtenga el estado de todas las API de datos F1 (Ergast, OpenF1, Live Timing)

Parámetros: Ninguno

Ejemplo:

Check status of all F1 data APIs and get recommendations

Devuelve: Informe completo del estado de las API con recomendaciones para fuentes de datos óptimas.

Tipos de Sesión

  • Practice 1, Practice 2, Practice 3
  • Qualifying, Sprint, Race

Abreviaturas de Pilotos

  • HAM (Hamilton), VER (Verstappen), LEC (Leclerc)
  • RUS (Russell), NOR (Norris), PER (Perez)
  • Y todos los demás pilotos de F1...

🔄 Actualizaciones

Para actualizar el F1 MCP Server:

# Pull latest changes
git pull origin main

# Install any new dependencies  
npm install

# Run tests to verify
npm test

# Restart Claude Desktop

📄 Licencia

Licencia MIT - Consulte el archivo LICENSE para más detalles.

🤝 Contribuciones

  1. Haga un fork del repositorio
  2. Cree una rama de características (git checkout -b feature/amazing-feature)
  3. Realice sus cambios (git commit -m 'Add amazing feature')
  4. Envíe los cambios a la rama (git push origin feature/amazing-feature)
  5. Abra una Pull Request

📞 Soporte

Para problemas y preguntas:

  • Consulte la sección de solución de problemas anterior
  • Revise los registros en logs/combined.log y logs/error.log
  • Abra un problema en GitHub con mensajes de error detallados

¡Listo para revolucionar tu análisis de F1 con Claude! 🏁