🏎️ MCP Server F1Analisys

<img src="./content/example.gif" width="1000">

A Model Context Protocol (MCP) server for interacting with F1Analisys through LLM interfaces like Claude. You will need to have Claude installed on your system to continue.

Instalation

First of all, you need to install mcp-f1analisys package from pypi with pip, using the following command:

pip install mcp-f1analisys

To use mcp-f1analisys server in claude can be configured by adding the following to your configuration file.

• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the F1Analisys MCP server configuration:

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

Tools

• Track dominance
• Top speed
• Lap time average
• Lap time distribution
• Team performance
• Fastest laps
• Race position evolution
• Fatest drivers each compound
• Comparative lap time
• Throttle usage
• Braking usage
• Long runs
• Optimal lap impact

Launch

Active the virtual environment and install the requirements using:

.\.venv\Scripts\activate

Install the mcp server in Claude using the following command:

mcp install .\server.py

Requirements

The requirementes used to build this MCP server are:

• mcp[cli]
• httpx
• fastmcp

Testing

You can test the server using the MCP Inspector:

mcp dev .\server.py

License

Source Code

The source code of this project is licensed under the Apache License 2.0.

Data

This project uses Formula 1 data from FastF1 created by the FastF1 contributors, licensed under the MIT License license.

Notice

MCPF1Analisys is unofficial and are not associated in any way with the Formula 1 companies. F1, FORMULA ONE, FORMULA 1, FIA FORMULA ONE WORLD CHAMPIONSHIP, GRAND PRIX and related marks are trade marks of Formula One Licensing B.V.