Formula 1

An F1 racing data MCP server based on TypeScript, providing access to real - time and historical F1 race data.

Entertainment and media Research and data #Racing data #Real - time query #Historical races #F1 analysis Local .TypeScript

rating : 2.5 points

downloads : 7.6K

update time : 2025-04-28

Open Site

Formula 1 Data Query System Documentation

🚀 Formula1 MCP Server 🏎️💨

A TypeScript-based Formula 1 MCP server that brings real-time and historical F1 racing data directly to your fingertips via the Model Context Protocol. It's faster than Verstappen on a hot lap! (Well, maybe not that fast, but it's trying hard!)

🚀 Quick Start

This Formula 1 MCP server allows you to access a wealth of F1 data, including real-time and historical information. Let's get it up and running!

✨ Features

Rich Data Resources:
- Access F1 session data via standard URIs.
- Real-time timing data (OpenF1).
- Historical data (Ergast API/FastF1).
- Driver information.
- Constructor information.
- Grand Prix information.
- Calendar.
- Weather and environmental data.
Comprehensive API Functions:
- Get Real-time Data:
  - getLiveTimingData(): Retrieve real-time timing data for the current race.
  - getCurrentSessionStatus(): Obtain status information for the current session.
- Get Historical Data:
  - getHistoricalResults(year, raceNumber): Fetch the race results for a specified year and race number.
  - getSeasonStandings(year): Get the driver standings for a specified year.
  - getConstructorStandings(year): Retrieve the constructor standings for a specified year.
- Get Driver Information:
  - getDriverInformation(driverId): Obtain detailed information about a specified driver, including career statistics.
  - getDriverStatistics(driverId): Get statistical information about a specified driver, such as the number of races and wins.
- Get Constructor Information:
  - getConstructorInformation(constructorId): Fetch detailed information about a specified constructor, including car specifications and historical results.
- Get Grand Prix Information:
  - getGrandPrixSchedule(year): Retrieve the Grand Prix calendar for a specified year.
  - getCircuitDetails(circuitId): Obtain detailed information about a specified circuit, such as length, layout, and records.

📦 Installation

Quick Installation with Smithery

smithy add github:Panther-FML/Formula1-MCP

Manual Installation

Clone the repository:

git clone https://github.com/Panther-FML/Formula1-MCP.git
cd Formula1-MCP

Install dependencies:

npm install

Build the project:

npm run build

📚 Documentation

Configuration

Add the following content to your MCP configuration file:

{
  "formula1": {
    "enabled": true,
    "path": "./dist/index.js",
    "args": [],
    "env": {},
    "cwd": "./Formula1-MCP"
  }
}

💻 Usage Examples

Basic Usage

// Get the driver standings for the 2023 season
const standings = await getSeasonStandings(2023);

// Get the results of the Japanese Grand Prix
const japanResults = await getHistoricalResults(2023, 18);

// Get the statistics of Lewis Hamilton
const hamiltonStats = await getDriverStatistics("hamilton");