# 🏎️ 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:
```commandline
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:
```json
{
  "mcpServers": {
    "mcp-f1analisys": {
      "command": "python",
      "args": [ "-m", "mcp-f1analisys" ]
    }
  }
}
```

## Tools 
- Track dominance ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Top speed ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Lap time average ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Lap time distribution ![Sesión Oficial](https://img.shields.io/badge/-Official-blue)
- Team performance ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Fastest laps ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Race position evolution ![Sesión Oficial](https://img.shields.io/badge/-Races-orange) ![Sesión Oficial](https://img.shields.io/badge/-Sprints-yellow)
- Fatest drivers each compound ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Comparative lap time ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Throttle usage ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Braking usage ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Long runs ![Sesión Oficial](https://img.shields.io/badge/-Official-blue) ![Sesión Oficial](https://img.shields.io/badge/-Pretesting-red)
- Optimal lap impact ![Sesión Oficial](https://img.shields.io/badge/-Qualy-orange) ![Sesión Oficial](https://img.shields.io/badge/-SprintQualy-yellow) ![Sesión Oficial](https://img.shields.io/badge/-SprintShootout-pink)

## Launch
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:
- `mcp[cli]`
- `httpx`
- `fastmcp`

## Testing 
You can test the server using the MCP Inspector:
```commandline
mcp dev .\server.py
```

## License

### 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 [**FastF1**](https://github.com/theOehrly/Fast-F1) 
created by the FastF1 contributors, licensed under the 
[MIT License](https://opensource.org/licenses/MIT) 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.