MCP Server F1Data

Provides an MCP server to query Formula 1 data via LLMs, offering tools for circuits, races, seasons, and more.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 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": {
    "maxbleu-mcp-f1data": {
      "command": "python",
      "args": [
        "-m",
        "mcp-f1data"
      ]
    }
  }
}

You set up this MCP server to interact with F1Data through your LLM interface, enabling natural-language queries to fetch circuit data, race details, seasons, and more. It runs locally as a standard MCP server and is designed to be used with Claude-installed clients for interactive querying and data retrieval.

How to use

You connect to this MCP server from an MCP client or platform that supports MCP endpoints. Once the server is running, you can ask for data like circuits, constructors, drivers, races, seasons, and related statistics. The tools exposed by the server let you fetch structured information from Formula 1 data sources, perform lookups, and chain queries to build richer insights for analyses, summaries, or decision-making tasks.

How to install

Prerequisites you need before installing the server are Python and a functioning environment for running Python packages. You should also have Claude installed on your system to configure and run the MCP server in Claude.

Step 1: Create and activate a virtual environment.

# Windows
python -m venv .venv
.\.venv\Scripts\activate

# macOS/Linux
python3 -m venv .venv
source .venv/bin/activate

Step 2: Install the MCP server package from PyPI.

pip install mcp-f1data

Step 3: Install the MCP server into Claude using the provided command.

mcp install .\server.py

Step 4: Start the server for development and testing.

mcp dev .\server.py

Step 5: Optional configuration snippet to connect Claude to the MCP server. Add this to Claude’s configuration under your MCP servers section.

{
  "mcpServers": {
    "mcp_f1data": {
      "command": "python",
      "args": [ "-m", "mcp-f1data" ]
    }
  }
}

Additional setup notes

Install requirements listed for building and running this MCP server: fastf1, pandas, fastmcp, websockets, mcp, pydantic, fastapi.

Configuration and usage notes

The server is exposed as a local stdio MCP endpoint. It runs via the Python interpreter and loads the mcp-f1data module to provide the F1Data data interface to your MCP client.

Available tools

circuit

Fetch information about Formula 1 circuits, including locations, grand prix history, and related metadata.

constructor

Query constructor teams, their nationalities, and historical performance.

driver

Retrieve driver profiles, standings, and statistics across seasons.

grand prix

Access details of individual Grands Prix, including date, location, and results.

manufacturer

Obtain data about Formula 1 manufacturers and their performance over time.

race

Get race results, lap times, and classifications for specific events.

season

Explore season-level data such as calendars, standings, and summaries.