Pitstop - Formula 1 Data MCP Server

A Model Context Protocol (MCP) server that provides access to Formula 1 data including championship standings, race results, and more.

Features

Current Features (MVP)

Driver Standings: Get current or historical driver championship standings
Constructor Standings: Get current or historical constructor/team championship standings

Planned Features

Live race data and telemetry
Race calendar and schedules
Historical race results
Latest F1 headlines and news
Head-to-head driver comparisons
Track information and layouts
All-time records and statistics

Data Sources

Pitstop integrates with multiple Formula 1 data sources:

FastF1: Official F1 timing data, telemetry, and race information (currently implemented)
Unofficial APIs: Real-time race data (planned)
RSS Feeds: Latest F1 news and headlines (planned)

Installation

Prerequisites

Python 3.10 or higher
pip

Install from source

# Clone or navigate to the pitstop directory cd pitstop # Install the package in development mode pip install -e .

Usage

Running as an MCP Server

The Pitstop server uses the Model Context Protocol to provide F1 data to MCP clients like Claude Desktop.

Configure Claude Desktop

Add this to your Claude Desktop configuration file:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "pitstop": { "command": "python", "args": ["-m", "pitstop.server"], "cwd": "C:\\projects\\pitstop\\src" } } }

Note: Update the cwd path to match your installation directory.

Restart Claude Desktop

After updating the configuration, restart Claude Desktop to load the Pitstop server.

Available Tools

get_driver_standings

Get Formula 1 driver championship standings.

Parameters:

year (optional): Year (e.g., "2024") or "current" for current season (default: "current")
round (optional): Round number (e.g., "5") or "last" for latest round. Leave empty for final standings.

Example queries to ask Claude:

"Show me the current F1 driver standings"
"What were the driver standings after round 10 in 2023?"
"Who won the 2020 driver championship?"

get_constructor_standings

Get Formula 1 constructor (team) championship standings.

Parameters:

year (optional): Year (e.g., "2024") or "current" for current season (default: "current")
round (optional): Round number (e.g., "5") or "last" for latest round. Leave empty for final standings.

Example queries to ask Claude:

"Show me the current constructor standings"
"What were the team standings in 2021?"
"Show me the constructor standings after the last race"

Project Structure

pitstop/ src/ pitstop/ __init__.py # Package initialization server.py # MCP server implementation data_sources/ __init__.py fastf1_client.py # FastF1 data client features.txt # Feature roadmap pyproject.toml # Project configuration README.md # This file

Development

Install development dependencies

pip install -e ".[dev]"

Code formatting

# Format code with Black black src/ # Lint with Ruff ruff check src/

Testing

pytest

API Credits

FastF1 - Python library for accessing Formula 1 timing data and telemetry

License

MIT

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Future Enhancements

See features.txt for the full roadmap of planned features including:

Live race data and telemetry
Race weekend mode with real-time updates
Head-to-head driver comparisons
Track information and weather forecasts
F1 news and headlines
Historical statistics and records

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides access to Formula 1 data including driver and constructor championship standings with support for current and historical seasons. Enables users to query F1 championship information through natural language with plans for expanded race data and telemetry.

Pitstop