Formula One MCP Server
This Model Context Protocol (MCP) server provides access to Formula One data and statistics using the FastF1 Python library. It allows you to access race calendars, event information, session results, driver data, lap times, telemetry, and championship standings through a clean MCP interface.
Features
- Get Formula One race calendars for specific seasons
- Retrieve detailed information about Grand Prix events
- Get session results (Race, Qualifying, Practice)
- Access driver information and statistics
- Analyze driver performance with lap times and telemetry data
- Compare multiple drivers' performance
- Get championship standings for drivers and constructors
Prerequisites
- Node.js 18 or later
- Python 3.8 or later
- FastF1 library
Installation
1. Install Python dependencies
pip install fastf1 pandas numpy
2. Install Node.js dependencies
cd f1-mcp-server
npm install
3. Build the TypeScript code
npm run build
4. Add to MCP settings
Add the following to your Cline MCP settings file (~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):
{
"mcpServers": {
"formula1": {
"command": "node",
"args": ["/Users/rakeshgangwar/Documents/Cline/MCP/f1-mcp-server/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
Available Tools
1. get_event_schedule
Get Formula One race calendar for a specific season.
Parameters:
year (number): Season year (e.g., 2023)
2. get_event_info
Get detailed information about a specific Formula One Grand Prix.
Parameters:
year (number): Season year (e.g., 2023)identifier (string): Event name or round number (e.g., "Monaco" or "7")
3. get_session_results
Get results for a specific Formula One session.
Parameters:
year (number): Season year (e.g., 2023)event_identifier (string): Event name or round number (e.g., "Monaco" or "7")session_name (string): Session name (e.g., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")
4. get_driver_info
Get information about a specific Formula One driver.
Parameters:
year (number): Season year (e.g., 2023)event_identifier (string): Event name or round number (e.g., "Monaco" or "7")session_name (string): Session name (e.g., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")driver_identifier (string): Driver identifier (number, code, or name; e.g., "44", "HAM", "Hamilton")
5. analyze_driver_performance
Analyze a driver's performance in a Formula One session.
Parameters:
year (number): Season year (e.g., 2023)event_identifier (string): Event name or round number (e.g., "Monaco" or "7")session_name (string): Session name (e.g., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")driver_identifier (string): Driver identifier (number, code, or name; e.g., "44", "HAM", "Hamilton")
6. compare_drivers
Compare performance between multiple Formula One drivers.
Parameters:
year (number): Season year (e.g., 2023)event_identifier (string): Event name or round number (e.g., "Monaco" or "7")session_name (string): Session name (e.g., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")drivers (string): Comma-separated list of driver codes (e.g., "HAM,VER,LEC")
7. get_telemetry
Get telemetry data for a specific Formula One lap.
Parameters:
year (number): Season year (e.g., 2023)event_identifier (string): Event name or round number (e.g., "Monaco" or "7")session_name (string): Session name (e.g., "Race", "Qualifying", "Sprint", "FP1", "FP2", "FP3")driver_identifier (string): Driver identifier (number, code, or name; e.g., "44", "HAM", "Hamilton")lap_number (number, optional): Lap number (gets fastest lap if not provided)
8. get_championship_standings
Get Formula One championship standings.
Parameters:
year (number): Season year (e.g., 2023)round_num (number, optional): Round number (gets latest standings if not provided)
Example Usage
Once the server is added to your MCP settings and running, you can use these tools with Cline to access Formula One data.
Example queries:
- "Show me the 2023 Formula One race calendar"
- "Get the results from the 2022 Monaco Grand Prix"
- "Compare Hamilton and Verstappen's performance in the 2021 British Grand Prix"
- "Show me the telemetry data from Leclerc's fastest lap in the 2023 Italian Grand Prix qualifying"
- "What are the current F1 championship standings?"
Data Source
This server uses the FastF1 Python library, which provides access to official Formula 1 timing data, car telemetry, and session results.
License
MIT
