What is F1 Mcp Server Node

f1-mcp-server-node is a server that provides real-time and historical Formula 1 racing data through a standardized API interface, enabling developers to access various racing metrics and information.

Use cases

Use cases include accessing live timing data during races, retrieving historical race results, monitoring weather conditions, analyzing driver standings, and tracking telemetry and pit stop data.

How to use

To use f1-mcp-server-node, clone the repository, install dependencies, set up environment variables, and configure it in your development environment. You can run it in development or production mode as needed.

Key features

Key features include live timing data, weather and track conditions, enhanced car telemetry, pit stop information, team radio communications, race control messages, track position visualization, and historical race results and statistics.

Where to use

f1-mcp-server-node can be used in various fields such as sports analytics, application development for racing enthusiasts, and integration into broadcasting systems for real-time data delivery.

The Formula1 MCP Server ! 🏎️💨

A TypeScript-based Formula 1 MCP server, bringing the thrill of real-time and historical F1 racing data straight to your fingertips via the Model Context Protocol. Faster than Verstappen on a hot lap! (Okay, maybe not that fast, but it’s trying!)

Resources

• Access F1 session data via standardized URIs
• Real-time telemetry data
• Historical race information
• Driver and constructor standings
• Weather data
• Circuit information

Getting Started

Quick Install via Smithery

To install the Formula 1 MCP Server automatically via Smithery:

npx -y @smithery/cli install @Panth1823/formula1-mcp --client claude

Manual Installation

1. Clone the repo:

git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp

2. Install:

npm install

3. Build:

npm run build

Setup

Add to your MCP client config:

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": [
        "<path-to-your-cloned-repo>/build/index.js"
      ],
      "cwd": "<path-to-your-cloned-repo>",
      "enabled": true
    }
  }
}

Config locations:

• Windows: %APPDATA%\.cursor\mcp.json
• MacOS: ~/.cursor/mcp.json
• Linux: ~/.config/.cursor/mcp.json

Available Tools

1. getLiveTimingData

Get real-time timing data for the current session.

Parameters:

• None required

2. getCurrentSessionStatus

Get status information about the current session.

Parameters:

• None required

3. getDriverInfo

Get information about a specific driver.

Parameters:

• driverId (string): Driver identifier (e.g., “max_verstappen”, “lewis_hamilton”)

4. getHistoricalSessions

Find session keys for historical events.

Parameters:

• year (number, optional): Season year (e.g., 2023)
• circuit_short_name (string, optional): Circuit name (e.g., “monza”, “spa”)
• country_name (string, optional): Country name (e.g., “Italy”, “Belgium”)
• session_name (string, optional): Session type (e.g., “Race”, “Qualifying”)

5. getHistoricRaceResults

Get race results for a specific historical race.

Parameters:

• year (number): Season year (e.g., 2023)
• round (number): Race number (e.g., 1, 2, 3)

6. getDriverStandings

Get driver championship standings.

Parameters:

• year (number): Season year (e.g., 2023)

7. getConstructorStandings

Get constructor championship standings.

Parameters:

• year (number): Season year (e.g., 2023)

8. getLapTimes

Get lap times for a specific driver.

Parameters:

• year (number): Season year (e.g., 2023)
• round (number): Race number (e.g., 1, 2, 3)
• driverId (string): Driver identifier (e.g., “max_verstappen”, “lewis_hamilton”)

9. getWeatherData

Get weather data for a session.

Parameters:

• sessionKey (string, optional): Session identifier

10. getCarData

Get detailed car telemetry data.

Parameters:

• driverNumber (string): Driver’s car number (e.g., “44”, “33”)
• sessionKey (string, optional): Session identifier
• filters (string, optional): Data filters

11. getPitStopData

Get pit stop information.

Parameters:

• driverNumber (string, optional): Driver’s car number
• sessionKey (string, optional): Session identifier

12. getTeamRadio

Get team radio communications.

Parameters:

• driverNumber (string, optional): Driver’s car number
• sessionKey (string, optional): Session identifier

13. getRaceControlMessages

Get race control messages.

Parameters:

• sessionKey (string, optional): Session identifier

14. getRaceCalendar

Get the F1 race calendar.

Parameters:

• year (number): Season year (e.g., 2023)

15. getCircuitInfo

Get detailed circuit information.

Parameters:

• circuitId (string): Circuit identifier (e.g., “monza”, “spa”)

16. getSeasonList

Get a list of available F1 seasons.

Parameters:

• limit (number, optional): Number of seasons to return

17. getQualifyingResults

Get qualifying session results.

Parameters:

• year (number): Season year (e.g., 2023)
• round (number): Race number (e.g., 1, 2, 3)

18. getDriverInformation

Get detailed driver information from Ergast API.

Parameters:

• driverId (string): Driver identifier (e.g., “max_verstappen”, “lewis_hamilton”)

19. getConstructorInformation

Get detailed constructor information from Ergast API.

Parameters:

• constructorId (string): Constructor identifier (e.g., “red_bull”, “mercedes”)

20. clearCache

Clear the local cache for F1 data.

Parameters:

• None required

Data Sources

• Live data: F1 Live Timing API (OpenF1)
• Historical: Ergast API (FastF1)

Examples

• “Show 2023 Monaco GP results”
• “Get current standings”
• “Weather at Silverstone”
• “Hamilton’s lap times”
• “Show 2024 calendar”
• “Verstappen’s info”
• “Japanese GP qualifying”

Debug

Use MCP Inspector for debugging.

Help

• Bugs? Report here
• Questions? Open an issue
• Want to help? Submit a PR

License

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