F1

What is f1-mcp?

f1-mcp is a Model Context Protocol (MCP) server built with Python that provides access to comprehensive Formula 1 data. It leverages the FastF1 library to retrieve information such as race results, driver details, lap times, telemetry, and circuit specifics.

How to use f1-mcp?

Installation: Install using hatch:

pip install f1-mcp

Running the Server: You can run the server using hatch, python directly, or the MCP inspector:

Using hatch:

hatch run f1_mcp_server.py

Using python directly:

python src/f1_mcp/f1_mcp_server.py

Using the MCP inspector:

npx @modelcontextprotocol/inspector python src/f1_mcp/f1_mcp_server.py

Claude Desktop Configuration: Add the following configuration to your claude_desktop_config.json file, replacing path/to/your/f1_mcp_server.py with the actual path:

{
  "mcpServers": {
    "f1-stats": {
      "command": "python",
      "args": ["path/to/your/f1_mcp_server.py"],
      "env": {}
    }
  }
}

Important Note: Set a large timeout for requests as FastF1 can take time to load data initially. The server automatically creates a local cache (f1_data_cache) for faster subsequent requests.

Key Features of f1-mcp

• Comprehensive F1 Data Access: Provides access to a wide range of Formula 1 data.
• Driver Information: Retrieve details about F1 drivers.
• Race Results: Get results for races and specific sessions (FP1, FP2, FP3, Qualifying, Sprint, Race).
• Circuit Information: Access details about circuits and event information.
• Lap Data: Obtain all lap data for drivers and identify the fastest lap.
• Telemetry Data: Get detailed telemetry data including speed, throttle, and brake information.
• Local Caching: Automatically caches F1 data to improve performance and reduce load times for subsequent requests.

Use Cases for f1-mcp

• F1 Data Analysis: Developers and enthusiasts can use this to build applications that analyze F1 data.
• Statistical Research: Conduct statistical analysis on historical F1 performance.
• Application Development: Integrate F1 data into custom applications, dashboards, or tools.
• Educational Purposes: Learn about F1 data structures and how to access them programmatically.

FAQ about f1-mcp

• Why do requests take a long time? FastF1 takes time to load data upon startup, especially for first-time requests for a season as data is downloaded and cached. It is recommended to set a large timeout for requests.
• Does it cache data? Yes, the server automatically creates a local cache directory (f1_data_cache) to store F1 data for faster subsequent requests.
• What are the available session types? Session types include FP1, FP2, FP3, Q1, Q2, Q3, Sprint, and Race.
• How are driver codes formatted? Driver codes are typically 3-letter abbreviations (e.g., HAM, VER, LEC).

f1-mcp

A Model Context Protocol (MCP) server that provides access to Formula 1 data including race results, driver information, lap times, telemetry, and circuit details using the FastF1 library.

Installation

Installation is done using hatch.

pip install f1-mcp

Running the Server

Using hatch:

hatch run f1_mcp_server.py

Using python directly:

python src/f1_mcp/f1_mcp_server.py

Using the MCP inspector:

npx @modelcontextprotocol/inspector python src/f1_mcp/f1_mcp_server.py

Make sure to set a large timeout for requests, FastF1 takes a long time to load data upon startup.

The server will start and create a local cache directory (f1_data_cache) to store F1 data for faster subsequent requests.

Claude Desktop Configuration

Add the following configuration to your claude_desktop_config.json file:

{
  "mcpServers": {
    "f1-stats": {
      "command": "python",
      "args": ["path/to/your/f1_mcp_server.py"],
      "env": {}
    }
  }
}

Replace path/to/your/f1_mcp_server.py with the actual path to your server file.

Available Endpoints

Driver Information

• get_drivers_tool - Get F1 drivers for a season, optionally filtered by name or code query

Race Results

• get_race_results_tool - Get race results for a season, optionally filtered by specific race name
• get_session_results_tool - Get session results for a specific race and session type (FP1, FP2, FP3, Qualifying, Sprint, Race)

Circuit Information

• get_circuit_info_tool - Get circuit information and event details for a specific race

Lap Data

• get_driver_laps_tool - Get all lap data for a specific driver in a specific session
• get_fastest_lap_tool - Get the fastest lap information for a specific session

Telemetry

• get_lap_telemetry_tool - Get detailed telemetry data (speed, throttle, brake, etc.) for a specific lap

Notes

• Make sure to set a large timeout for requests, FastF1 takes a long time to load data upon startup.
• The server automatically caches F1 data locally to improve performance
• First-time requests for a season may take longer as data is downloaded and cached
• Session types include: FP1, FP2, FP3, Q1, Q2, Q3, Sprint, Race
• Driver codes are typically 3-letter abbreviations (e.g., HAM, VER, LEC)