Open-F1-MCP-Server

This project implements the MCP Server for Open Formula 1

For more detailed information, please check Implementation of Open F1 MCP Server

I am a high school student and would like to know if my project is liked and/or used. If you like or use this MCP Server, please star in GitHub and share with your friends - thank you !!

Arya Akman

What is Open Formula 1

Open Formula 1 is an open-source API that provides real-time and historical Formula 1 data.

The API offers a wealth of information, including lap timings, car telemetry, radio communications, and more. Whether you're looking to create interactive dashboards, dive deep into race analysis, or even develop connected objects that light up every time your favorite driver takes the lead, OpenF1 makes it all possible.

Tools (as of v1.2)

get_sessions:

Retrieve F1 race sessions. Can filter by year, country, circuit, session type, etc. Returns session details including session_key, date, location, and type.

Parameter Description

year Filter by year (e.g., 2023, 2024).

country_name Filter by country name (e.g., 'Monaco', 'Italy').

circuit_short_name Filter by circuit short name (e.g., 'Monza', 'Monaco').

session_name Filter by session name (e.g., 'Race', 'Qualifying', 'Sprint').

session_key Get specific session by its unique session_key.

date_start Filter by start date (ISO format: YYYY-MM-DD). Supports filters like >= and

Installation instructions:

1. Install dependencies:

bashpip install mcp httpx

2. Add/update Claude desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "Open-F1": {
      "command": "python",
      "args": ["/path/to/OpenF1MCPServer.py"]
    }
  }
}

3. Restart Claude desktop and verify the installation

Go to Claude Desktop -> File -> Settings -> Developer

On the right side of the screen, look under Local MCP Servers and verify

• "Open-F1" shows up
• The state is "running" (highlighted with blue background)

Usage examples

The following example prompts can provide ideas on how to utilize this MCP Server

• ### Sessions (Race) related usage examples

• ### Driver related usage examples

• ### Lap information related usage examples

• ### Pit stop related usage examples

• ### Overtakes related usage examples

The server handles the API calls to OpenF1 and returns formatted data that Claude can interpret and present to you