About F1 MCP Server
F1 MCP Server is an MCP server published by Machine-To-Machine in the Developer Tools category: a Model Context Protocol (MCP) server that provides Formula One racing data for AI applications, including event schedules, driver information, telemetry data, race results, and performance analysis. It has been installed 0 times through Conduid.
The repository has 1 stars and 2 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx f1-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about F1 MCP Server
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Formula One MCP Server
A Model Context Protocol (MCP) server that provides Formula One racing data. This package exposes various tools for querying F1 data including event schedules, driver information, telemetry data, and race results.
Features
- Event Schedule: Access the complete F1 race calendar for any season
- Event Information: Detailed data about specific Grand Prix events
- Session Results: Comprehensive results from races, qualifying sessions, sprints, and practice sessions
- Driver Information: Access driver details for specific sessions
- Performance Analysis: Analyze a driver's performance with lap time statistics
- Driver Comparison: Compare multiple drivers' performances in the same session
- Telemetry Data: Access detailed telemetry for specific laps
- Championship Standings: View driver and constructor standings for any season
Installation
Installing via Smithery
To install f1-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Machine-To-Machine/f1-mcp-server --client claude
Manual Installation
In a uv managed python project, add to dependencies by:
uv add f1-mcp-server
Alternatively, for projects using pip for dependencies:
pip install f1-mcp-server
To run the server inside your project:
uv run f1-mcp-server
Or to run it globally in isolated environment:
uvx f1-mcp-server
To install directly from the source:
git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
pip install -e .
Usage
Command Line
The server can be run in two modes:
Standard I/O mode (default):
uvx run f1-mcp-server
SSE transport mode (for web applications):
uvx f1-mcp-server --transport sse --port 8000
Python API
from f1_mcp_server import main
# Run the server with default settings
main()
# Or with SSE transport settings
main(port=9000, transport="sse")
API Documentation
The server exposes the following tools via MCP:
| Tool Name | Description |
|---|---|
get_event_schedule |
Get Formula One race calendar for a specific season |
get_event_info |
Get detailed information about a specific Formula One Grand Prix |
get_session_results |
Get results for a specific Formula One session |
get_driver_info |
Get information about a specific Formula One driver |
analyze_driver_performance |
Analyze a driver's performance in a Formula One session |
compare_drivers |
Compare performance between multiple Formula One drivers |
get_telemetry |
Get telemetry data for a specific Formula One lap |
get_championship_standings |
Get Formula One championship standings |
See the FastF1 documentation for detailed information about the underlying data: FastF1 Documentation
Dependencies
- anyio (>=4.9.0)
- click (>=8.1.8)
- fastf1 (>=3.5.3)
- mcp (>=1.6.0)
- numpy (>=2.2.4)
- pandas (>=2.2.3)
- uvicorn (>=0.34.0)
Development
Setup Development Environment
git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"
Code Quality
# Run linting
uv run ruff check .
# Run formatting check
uv run ruff format --check .
# Run security checks
uv run bandit -r src/
Contribution Guidelines
- Fork the repository
- Create a feature branch:
git checkout -b feature-name - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin feature-name - Submit a pull request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Authors
- Machine To Machine
Acknowledgements
This project leverages FastF1, an excellent Python package for accessing Formula 1 data. We are grateful to its maintainers and contributors.
This project was inspired by rakeshgangwar/f1-mcp-server which was written in TypeScript. The f1_data.py module was mostly adapted from their source code.
README mirrored from the source repository 2 days ago. The original is authoritative.