f1-mcp

F1 MCP Server

A Model Context Protocol (MCP) server that provides comprehensive Formula 1 data and analytics for Claude Desktop integration.

Features

This server exposes 36+ tools for accessing F1 data:

Race Data

• Race results and classifications
• Sprint race results
• Qualifying progression (Q1, Q2, Q3)
• Grid vs finish comparisons
• DNF lists and retirement reasons

Telemetry & Analysis

• Speed trace comparisons between drivers
• Gear shift visualizations
• Brake and throttle analysis
• RPM and engine data
• DRS usage patterns

Timing & Laps

• Fastest lap data with sector times
• Lap-by-lap timing
• Deleted laps (track limits)
• Lap consistency statistics
• Personal best laps

Strategy

• Tire compound analysis
• Stint breakdowns
• Pit stop data and fastest stops
• Starting tire choices
• Strategy comparisons

Standings & History

• Driver championship standings
• Constructor standings
• Historical race winners
• Track records

Live Data

• Live session status
• Real-time positions
• Live lap times
• Live telemetry
• Current weather conditions

Other

• Team radio links
• Race control messages
• Track status (flags, safety car)
• Weather data
• Circuit information

Installation

Prerequisites

• Python 3.10 or higher
• Claude Desktop

Setup

• Clone this repository:

git clone https://github.com/drivenrajat/f1.git
cd f1

• Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

• Install dependencies:

pip install -e .

Configure Claude Desktop

Add this server to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "f1": {
      "command": "python",
      "args": ["/path/to/f1/f1_server.py"]
    }
  }
}

Or if using uv:

{
  "mcpServers": {
    "f1": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/f1", "python", "f1_server.py"]
    }
  }
}

Usage

Once configured, you can ask Claude questions like:

• "Show me the 2024 F1 calendar"
• "Get the race results from Monaco 2024"
• "Compare telemetry between Verstappen and Norris at Silverstone qualifying"
• "What was Hamilton's tire strategy at Spa?"
• "Show me the current driver standings"
• "Get the fastest pit stops from the Italian GP"

Data Sources

• FastF1: Historical telemetry, lap times, and session data
• Ergast API: Championship standings and historical results
• OpenF1 API: Team radio recordings

Caching

The server automatically caches FastF1 data in a cache directory to improve performance on repeated queries.

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.