F1 MCP Server Node

🚀 F1 MCP Server 🏎️💨

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

🚀 Quick Start

This F1 MCP server allows you to access real-time and historical racing data with ease. It provides a wide range of resources and features to enhance your F1 experience.

✨ Features

Resources

• Access session data
• Real-time telemetry
• Historical data
• Weather information
• Race control messages
• Driver and constructor information
• Race calendar
• Track information

📦 Installation

Quick Installation

npx -y @smithery/cli install @panth/f1-mcp-server

Manual Installation

1. Clone the repository:

   git clone https://github.com/Panth/f1-mcp-server.git
   

2. Install dependencies:

   cd f1-mcp-server && npm install
   

3. Start the server:

   node index.js
   

📚 Documentation

Configuration

Add the following to your mcp.config.json:

{
  "f1-mcp-server": {
    "enabled": true,
    "path": "./path/to/f1-mcp-server"
  }
}

On Windows, the path is:

C:\Users\<username>\.model-context\config\f1-mcp-server.json

On macOS/Linux, the path is:

~/.model-context/config/f1-mcp-server.json

Functional Modules

Data Retrieval Tools

• Get real-time timing data
• Query historical results
• Get weather information
• Get race control messages
• Get driver information
• Get constructor information
• Get the race calendar
• Get track information
• Clear the cache

Example Usage

• "Show the results of the 2023 Monaco Grand Prix"
• "Get the current standings"
• "What's the weather like at Silverstone?"
• "Hamilton's lap time data"
• "Show the 2024 race calendar"
• "Information about Verstappen"
• "Qualifying results of the Japanese Grand Prix"

Data Sources

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

Debugging

Use the MCP Inspector for debugging.

Support

• Have an issue? Report it here
• Have a question? Open an issue
• Want to help? Submit a PR

📄 License

This project is released under the MIT License. See the LICENSE file for details.