F1 MCP Server

Advanced Formula 1 Data Analysis MCP Server- Real-time telemetry, tire performance analysis, and race strategy simulation for Claude

A sophisticated Model Context Protocol (MCP) server that provides Claude with advanced Formula 1 analytics capabilities, including real-time telemetry processing, tire degradation modeling, weather impact analysis, and Monte Carlo race strategy simulation.

- Session Data Analysis- Comprehensive race weekend data with telemetry and weather
- Tire Performance Analysis- Advanced degradation modeling with thermal analysis
- Lap Time Analysis- Fuel-corrected analysis with 25 mini-sector breakdown
- Weather Impact Prediction- LSTM/CNN forecasting with strategic recommendations
- Race Strategy Simulation- Monte Carlo simulation with 300M-1B+ permutations
- Driver Performance Analysis- Skill extraction separating car vs. driver performance
- Real-time Telemetry Processing- Advanced signal analysis with anomaly detection
- Sector Performance Analysis- 25 mini-sector analysis with track curvature correlation

- Current Season Info- Live F1 season data with real-time status
- Race Schedule- Complete F1 calendar for 2018-2025 seasons
- Live Timing Connection- F1 Official Live Timing API integration
- API Status Monitoring- Real-time status of all F1 data sources

- Mathematical Models: Sophisticated tire degradation physics with thermal, mechanical, and chemical factors
- Signal Processing: FFT, wavelet analysis, and Kalman filtering for telemetry data
- Weather Modeling: Ensemble forecasting with LSTM/CNN hybrid models
- Strategy Optimization: Monte Carlo simulation with probabilistic outcomes and risk analysis
- Performance Extraction: Driver skill analysis with 88%/12% car/driver performance split

- Node.js18.0.0 or higher
- npm(comes with Node.js)
- Claude Desktopapplication

# Clone the repository git clone https://github.com/stagsz/F1-MCP-Server cd F1-mcp-server # Install dependencies npm install # Verify installation npm test

You need to add this MCP server to your Claude Desktop configuration file.

Edit the file at:%APPDATA%\Claude\claude_desktop_config.json

Edit the file at:~/Library/Application Support/Claude/claude_desktop_config.json

Edit the file at:~/.config/Claude/claude_desktop_config.json

Add the following configuration to yourclaude_desktop_config.jsonfile:

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

Important: Replacepath/to/F1-mcp-server/index.jswith the absolute path to your F1-mcp-server directory.

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

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

After saving the configuration file, completely quit and restart Claude Desktop for the changes to take effect.

Once Claude Desktop restarts, you can verify the F1 MCP Server is working by asking Claude:

Can you analyze tire performance for a Formula 1 race?

Claude should now have access to all F1 analysis capabilities and will use the MCP server to provide detailed analytics.

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

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

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

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

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

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

# Run test suite npm test # Run tests with coverage npm run test -- --coverage # Check syntax node --check index.js

# Start with auto-reload npm run dev # Check logs tail -f logs/combined.log

# Enable debug logging export LOG_LEVEL=debug npm start

- Telemetry Volume: 1.1M+ data points per second simulation
- Sampling Rate: 100Hz simulation
- Monte Carlo: 300M to 1B+ permutations per race
- Signal Processing: FFT, wavelet analysis, Kalman filtering

- Tire Degradation: Thermal, mechanical, and chemical factors
- Weather Forecasting: LSTM/CNN ensemble models
- Driver Analysis: 88%/12% car/driver performance split
- Strategy Optimization: Probabilistic outcome modeling

Supported F1 Data & Live Integration

- Years: 2018-2025 (including current 2025 season)
- Sessions: Practice 1-3, Qualifying, Sprint, Race
- Data Sources: F1 Live Timing → OpenF1 API → Ergast API → Advanced Simulation
- Live Data: Real-time telemetry during active F1 sessions
- Tire Compounds: C1-C6, Soft/Medium/Hard, Intermediates, Wets
- Weather: Live conditions, temperature, humidity, rain probability, wind
- Telemetry: Speed, throttle, brake, DRS, gear, RPM, tire temps, GPS coordinates

# Check Node.js version node --version # Should be 18.0.0+ # Verify dependencies npm install # Check syntax node --check index.js

- Verify the path inclaude_desktop_config.jsonis absolute and correct
- Ensure Claude Desktop was completely restarted after config changes
- Check that Node.js is in your system PATH

# Make index.js executable chmod +x index.js # Check file permissions ls -la index.js

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

Get comprehensive F1 session data including telemetry, timing, and weather

- year(required): Race year (2018-2025)
- round(required): Race round number (1-24)
- session(required): Session type

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

Get session data for 2024 Monaco Grand Prix qualifying

Returns:Comprehensive session overview with lap times, weather conditions, tire usage, and telemetry summaries.

Advanced tire performance analysis with degradation modeling and strategy insights

- year(required): Race year
- round(required): Race round number
- session(required): Session type
- driver(optional): Driver abbreviation (HAM, VER, LEC, etc.)
- compound(optional): Tire compound (SOFT, MEDIUM, HARD)

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

Returns:Detailed tire analysis including:

- Degradation curves with thermal modeling
- Grip loss patterns and optimal stint lengths
- Strategic recommendations for tire changes
- Performance comparison across compounds

Sophisticated lap time analysis with fuel correction and mini-sector breakdown

- year(required): Race year
- round(required): Race round number
- session(required): Session type
- driver(optional): Driver abbreviation
- fuel_corrected(optional): Apply fuel correction (default: true)

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

Returns:Advanced lap time analysis featuring:

- Fuel-corrected lap times and pace analysis
- 25 mini-sector performance breakdown
- Track evolution and session progression
- Comparative analysis vs field

Weather impact analysis and prediction for race strategy

- year(required): Race year
- round(required): Race round number
- session(required): Session type
- forecast_hours(optional): Forecast window in hours (default: 3)

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

Returns:Comprehensive weather analysis including:

- LSTM/CNN ensemble weather forecasting
- Rain probability and intensity predictions
- Strategic recommendations for tire choices
- Timing windows for optimal track conditions

Monte Carlo race strategy simulation with probabilistic outcomes

- year(required): Race year
- round(required): Race round number
- driver(required): Driver abbreviation
- strategy_options(optional): Array of strategies (e.g., ["soft-medium", "medium-hard"])
- simulations(optional): Number of Monte Carlo simulations (default: 10,000)

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

Returns:Detailed strategy analysis featuring:

- Monte Carlo simulation with 300M-1B+ permutations
- Probabilistic outcomes and success rates
- Risk analysis and optimal pit windows
- Strategy recommendations with confidence intervals

Driver performance extraction separating skill from car performance

- year(required): Race year
- round(required): Race round number
- session(required): Session type
- driver(required): Driver abbreviation
- comparison_driver(optional): Driver to compare against

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

Returns:Advanced driver analysis including:

- Skill extraction with 88%/12% car/driver performance split
- Driving style analysis and performance metrics
- Comparison vs teammate or specified driver
- Strengths and improvement areas identification

Real-time telemetry data processing with advanced signal analysis

- year(required): Race year
- round(required): Race round number
- session(required): Session type
- driver(required): Driver abbreviation
- lap(optional): Specific lap number
- channels(optional): Array of telemetry channels to analyze

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

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

Returns:Comprehensive telemetry analysis featuring:

- High-frequency data processing (100Hz simulation)
- FFT, wavelet analysis, and Kalman filtering
- Anomaly detection and performance optimization
- Comparative analysis and setup recommendations

25 mini-sector analysis with track curvature correlation

- year(required): Race year
- round(required): Race round number
- session(required): Session type
- driver(optional): Driver abbreviation

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

Returns:Detailed sector analysis including:

- 25 mini-sector performance breakdown
- Track curvature and elevation correlation
- Speed trap analysis and cornering performance
- Sector-specific setup and driving recommendations

Get current F1 season information including live data availability

- include_live_status(optional): Include live session status (default: true)