F1 MCP Server Node Implementation

F1 MCP Server Node Implementation

By Panth1823 GitHub

-

Overview

what is F1 MCP Server?

F1 MCP Server is a Formula 1 Machine Control Protocol (MCP) server that provides real-time and historical F1 racing data through a standardized API interface.

how to use F1 MCP Server?

To use F1 MCP Server, clone the repository, install the dependencies, set up environment variables, and start the server to listen for MCP protocol commands.

key features of F1 MCP Server?

  • Real-time session data from OpenF1
  • Historical race data from Ergast API
  • Driver telemetry and car data
  • Team radio and race control messages
  • Weather information
  • Championship standings
  • Circuit information
  • Pit stop data and analysis
  • In-memory caching for optimized performance
  • Comprehensive error handling
  • WebSocket support for live updates

use cases of F1 MCP Server?

  1. Providing live telemetry data during F1 races.
  2. Analyzing historical race performance and statistics.
  3. Integrating with other applications for real-time racing insights.

FAQ from F1 MCP Server?

  • What data sources does F1 MCP Server use?

It uses OpenF1 for real-time data and Ergast API for historical data.

  • Is F1 MCP Server open-source?

Yes! The project is available on GitHub for contributions and modifications.

  • How can I contribute to F1 MCP Server?

You can fork the repository, create a feature branch, and submit a pull request.

Content

F1 MCP Server Node Implementation

A TypeScript-based Formula 1 MCP server that provides real-time and historical F1 racing data through the Model Context Protocol.

Features

Resources

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

Functions

  • get_current_session - Get current session information
  • get_driver_standings - Get driver championship standings
  • get_constructor_standings - Get constructor standings
  • get_race_calendar - Get race calendar information
  • get_session_results - Get detailed session results
  • get_driver_performance - Get driver performance metrics
  • get_telemetry - Access detailed car telemetry
  • get_weather_data - Get weather information
  • get_circuit_info - Get circuit details and statistics

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

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

{
  "mcpServers": {
    "f1-mcp-server": {
      "command": "/path/to/f1-mcp-server-node/build/index.js"
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

No tools information available.
No content found.