F1 MCP Server

🚀 F1 MCP Server

An MCP (Model Context Protocol) server that provides Formula 1 racing data. This package offers various tools for querying race calendars, driver information, telemetry data, and race results.

✨ Features

• Race Calendar: Retrieve the Formula 1 race calendar for any season.
• Race Information: Obtain detailed data for a specific Grand Prix.
• Session Results: View comprehensive results for races, qualifying sessions, sprint races, and practice sessions.
• Driver Information: Query detailed information about drivers in a specific session.
• Performance Analysis: Analyze a driver's performance in a specific session, including lap time statistics.
• Driver Comparison: Compare the performance of different drivers in a race.
• Telemetry Data: Get real-time track data and vehicle status.

📦 Installation

Via Smithery

uv get package f1-mcp-server

Manual Installation

Install with pip

pip install f1-mcp-server

Clone the repository and install

git clone https://github.com/your-username/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

🚀 Quick Start

Command-line Usage

# Start the server
python -m f1_mcp_server.start

# Access the console
python -m f1_mcp_server.console

Python API Example

from f1_mcp_server import F1MCPClient

client = F1MCPClient()
print(client.get_circuit())

📚 Documentation

Project Structure

• f1_data.py: Contains all functions for interacting with Formula 1 data.
• server.py: Implements the core logic of the MCP server.
• config.py: Stores default configurations and environment variables.

Dependencies

flask==2.0.3
requests==2.26.0

Development Environment Setup

Create a virtual environment and install dependencies

uv venv
source .venv/bin/activate  # Use .venv\Scripts\activate for Windows users
pip install -r requirements.txt

Quality Control

Format Check

black .
flake8 .

Code Review

bandit run src/

🤝 Contribution Guidelines

1. Clone the repository

   git clone https://github.com/your-username/f1-mcp-server.git
   cd f1-mcp-server
   

2. Create a feature branch

   git checkout -b feature-name
   

3. Commit changes

   git add .
   git commit -m 'Add new feature'
   

4. Push to the remote repository

   git push origin feature-name
   

5. Create a pull request

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

👨‍💻 Author

• Machine To Machine

🙏 Acknowledgments

This project relies on FastF1, an excellent Python library for accessing Formula 1 data. We express our sincere gratitude to its maintainers and contributors.

This project is inspired by rakeshgangwar/f1-mcp-server, which is written in TypeScript. Most of the content in the f1_data.py module is adapted from its source code.