https://github.com/maxbleu/mcp-f1data
MCP server for F1 data using Fastf1, OpenF1 or Ergast APIs
https://github.com/maxbleu/mcp-f1data
ai ergast-api fastf1 jopilca mcp mcp-server modelcontextprotocol
Last synced: about 2 months ago
JSON representation
MCP server for F1 data using Fastf1, OpenF1 or Ergast APIs
- Host: GitHub
- URL: https://github.com/maxbleu/mcp-f1data
- Owner: Maxbleu
- License: mit
- Created: 2025-06-20T22:27:25.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2025-06-20T22:57:01.000Z (12 months ago)
- Last Synced: 2025-06-20T23:31:07.125Z (12 months ago)
- Topics: ai, ergast-api, fastf1, jopilca, mcp, mcp-server, modelcontextprotocol
- Language: Python
- Homepage:
- Size: 857 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🏎️ MCP Server F1Data
A Model Context Protocol (MCP) server for interacting with F1Data through LLM interfaces like Claude. **You will need to have Claude installed on your system to continue.**
## Getting Started
First of all, you need to install `mcp-f1data` package from pypi with pip, using the following command:
```commandline
pip install mcp-f1data
```
To use `mcp-f1data` 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 F1Data MCP server configuration:
```json
{
"mcpServers": {
"mcp-f1data": {
"command": "python",
"args": [ "-m", "mcp-f1data" ]
}
}
}
```
## Tools
- `circuit`
- `constructor`
- `driver`
- `grand prix`
- `manufacturer`
- `race`
- `season`
## Instalation
Active the virtual environment and install the requirements using:
```commandline
.\.venv\Scripts\activate
```
Install the mcp server in Claude using the following command:
```commandline
mcp install .\server.py
```
## Requirements
The requirementes used to build this MCP server are:
- `fastf1`
- `pandas`
- `fastmcp`
- `websockets`
- `mcp`
- `pydantic`
- `fastapi`
## Testing
You can test the server using the MCP Inspector:
```commandline
mcp dev .\server.py
```
## 📜 Licenses
### Source Code
The source code of this project is licensed under the [Apache License 2.0](./LICENSE).
### Data
This project uses Formula 1 data from [**F1DB**](https://github.com/f1db/f1db)
created by the F1DB contributors, licensed under the
[Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/) license.
The original data has been:
- Imported and structured into a PostgreSQL database
- Exposed through a custom MCP
- Optimized for efficient querying
The original data is provided "as-is" without warranties of any kind,
as per the terms of the CC BY 4.0 license.
For complete attribution details, see [ATTRIBUTIONS.md](./ATTRIBUTIONS.md)..
## Notice
MCPF1Data 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.