F1
- javascript
3
GitHub Stars
javascript
Language
5 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"stagsz-f1-mcp-server": {
"command": "node",
"args": [
"path/to/F1-mcp-server/index.js"
],
"env": {
"NODE_ENV": "production"
}
}
}
}You have an Advanced Formula 1 Data Analysis MCP Server that brings real-time telemetry, tire and weather analytics, and Monte Carlo race strategy simulation to Claude. It provides deep, data-driven insights to help you analyze sessions, model tire behavior, predict weather impacts, and optimize race strategy in an automated, scalable way.
How to use
You interact with the MCP Server through your MCP client. First connect the F1 MCP Server to Claude Desktop so Claude can route requests to the server. Once connected, you can ask Claude to analyze tire performance, run race strategy simulations, predict weather impact, or study driver and sector performance. The server processes telemetry at high frequency and returns actionable analytics that you can review in your workspace.
Practical usage patterns you can perform include:
- Analyze tire performance for a specific driver, race, and compound to understand degradation and optimal pit windows.
- Run Monte Carlo simulations to compare one-stop vs two-stop strategies for a given Grand Prix and year.
- Predict weather impact for upcoming sessions and get tire strategy recommendations.
- Extract driver performance metrics to separate skill from car performance and compare against teammates.
- Process real-time telemetry to detect anomalies and optimize setup during live sessions.
How to install
# Step 1: Clone the MCP server repository
git clone https://github.com/stagsz/F1-MCP-Server
cd F1-mcp-server
# Step 2: Install dependencies
npm install
# Step 3: Run tests to verify installation
npm test
Next, configure Claude Desktop to load the MCP server. You will add a new MCP server entry that runs the server locally.
Windows configuration example shows the local server running with Node.js and the path to the server script. Use the absolute path to your local directory in your environment.
{
"mcpServers": {
"f1_mcp": {
"command": "node",
"args": ["C:\\Users\\YourName\\F1-mcp-server\\index.js"],
"env": {
"NODE_ENV": "production"
}
}
}
}
Configuration and startup notes
You add the MCP server to Claude Desktop by editing the client configuration file. The example below uses a local stdio server entry. Ensure the path to the server script is correct for your operating system.
{
"mcpServers": {
"f1_mcp": {
"command": "node",
"args": ["path/to/F1-mcp-server/index.js"],
"env": {
"NODE_ENV": "production"
}
}
}
}
Verification
After you restart Claude Desktop, verify the MCP server is connected by asking Claude a capability-based question such as: Can you analyze tire performance for a Formula 1 race? Claude should utilize the MCP server to provide detailed analytics.
Usage examples
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
Development and troubleshooting
If you need to run tests or start in development mode, use the provided commands to run tests, enable auto-reload, or adjust logging.
# Run test suite
npm test
# Run tests with coverage
npm run test -- --coverage
# Check syntax
node --check index.js
Technical considerations
The MCP server supports high-frequency telemetry processing and advanced analytical models, including Monte Carlo strategy simulations and temperature- and track-aware tire degradation models. It can ingest live data via supported sources and deliver probabilistic outcomes with risk analysis to inform decision-making during sessions.
Notes on security and access
Only expose the MCP server to trusted clients and ensure you run production builds with appropriate environment configurations. Keep the server URL and local paths secure and restrict access to Claude Desktop configurations.
Complete tool documentation
Core analysis tools and 2025 live data tools are available through the MCP server. You can query for session data, tire performance, lap times with fuel correction, weather impact, race strategy simulation, driver performance, real-time telemetry, sector performance, current season info, race schedules, live timing connections, and API status.
Available tools
get_session_data
Get comprehensive F1 session data including telemetry, timing, and weather with a detailed session overview.
analyze_tire_performance
Advanced tire performance analysis with degradation modeling and strategic recommendations.
analyze_lap_times
Sophisticated lap time analysis with fuel correction and 25 mini-sector breakdown.
predict_weather_impact
Weather impact analysis and prediction for race strategy using ensemble models.
simulate_race_strategy
Monte Carlo race strategy simulation with probabilistic outcomes and risk analysis.
analyze_driver_performance
Driver performance extraction separating skill from car performance.
get_real_time_telemetry
Real-time telemetry data processing with FFT, wavelet analysis, and Kalman filtering.
analyze_sector_performance
25 mini-sector analysis with track curvature correlation.
get_current_season_info
Get current F1 season information including live data availability.
get_race_schedule
Get F1 race schedule for a given year including 2025.
connect_live_timing
Connect to F1 Official Live Timing API for real-time data.
get_live_timing_status
Get status of F1 Live Timing API connection.
get_api_status
Get status of all F1 data APIs with recommendations.