Skip to main content
Glama
Formula One MCP Server (Python)

Formula One MCP Server (Python)

フォーミュラワン MCP サーバー

PyPIバージョン Pythonのバージョン ライセンス: MIT 鍛冶屋のバッジ

F1レースデータを提供するモデルコンテキストプロトコル(MCP)サーバー。このパッケージは、イベントスケジュール、ドライバー情報、テレメトリデータ、レース結果など、F1データを照会するための様々なツールを公開しています。

特徴

  • イベントスケジュール: どのシーズンでも完全なF1レースカレンダーにアクセスできます

  • イベント情報:特定のグランプリイベントに関する詳細データ

  • セッション結果: レース、予選セッション、スプリント、練習セッションの総合結果

  • ドライバー情報: 特定のセッションのドライバーの詳細にアクセスします

  • パフォーマンス分析: ラップタイム統計でドライバーのパフォーマンスを分析する

  • ドライバー比較: 同じセッションで複数のドライバーのパフォーマンスを比較します

  • テレメトリデータ: 特定のラップの詳細なテレメトリにアクセスします

  • チャンピオンシップ順位表: どのシーズンでもドライバーとコンストラクターの順位表を表示

Related MCP server: Formula One MCP Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の f1-mcp-server を自動的にインストールするには:

npx -y @smithery/cli install @Machine-To-Machine/f1-mcp-server --client claude

手動インストール

uv管理 Python プロジェクトでは、次のように依存関係を追加します。

uv add f1-mcp-server

あるいは、依存関係にpipを使用するプロジェクトの場合:

pip install f1-mcp-server

プロジェクト内でサーバーを実行するには:

uv run f1-mcp-server

または、分離された環境でグローバルに実行するには:

uvx f1-mcp-server

ソースから直接インストールするには:

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

使用法

コマンドライン

サーバーは次の 2 つのモードで実行できます。

標準I/Oモード(デフォルト):

uvx run f1-mcp-server

SSE トランスポート モード(Web アプリケーション用):

uvx f1-mcp-server --transport sse --port 8000

Python API

from f1_mcp_server import main

# Run the server with default settings
main()

# Or with SSE transport settings
main(port=9000, transport="sse")

APIドキュメント

サーバーは、MCP を介して次のツールを公開します。

ツール名

説明

get_event_schedule

特定のシーズンのF1レースカレンダーを取得する

get_event_info

特定のF1グランプリに関する詳細情報を入手

get_session_results

特定のF1セッションの結果を取得する

get_driver_info

特定のF1ドライバーに関する情報を取得する

analyze_driver_performance

F1セッションでのドライバーのパフォーマンスを分析する

compare_drivers

複数のF1ドライバーのパフォーマンスを比較する

get_telemetry

特定のF1ラップのテレメトリデータを取得する

get_championship_standings

F1チャンピオンシップの順位表を見る

基礎データの詳細については、FastF1 ドキュメントを参照してください: FastF1 ドキュメント

依存関係

  • anyio (>=4.9.0)

  • クリック (>=8.1.8)

  • fastf1 (>=3.5.3)

  • mcp (>=1.6.0)

  • numpy (>=2.2.4)

  • パンダ (>=2.2.3)

  • uvicorn (>=0.34.0)

発達

開発環境のセットアップ

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

コード品質

# Run linting
uv run ruff check .

# Run formatting check
uv run ruff format --check .

# Run security checks
uv run bandit -r src/

寄稿ガイドライン

  1. リポジトリをフォークする

  2. 機能ブランチを作成する: git checkout -b feature-name

  3. 変更をコミットします: git commit -am 'Add some feature'

  4. ブランチにプッシュ: git push origin feature-name

  5. プルリクエストを送信する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

著者

  • マシンツーマシン

謝辞

このプロジェクトは、F1データにアクセスするための優れたPythonパッケージであるFastF1を活用しています。FastF1のメンテナーと貢献者の皆様に感謝申し上げます。

このプロジェクトは、TypeScriptで書かれたrakeshgangwar/f1-mcp-serverに触発されました。f1_data.pyモジュールはf1_data.py主にそのソースコードから改変したものです。

Available Tools

8 tools
analyze_driver_performanceC

Analyze a driver's performance in a Formula One session

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required).

compare_driversB

Compare performance between multiple Formula One drivers

Inputs: year (required), event_identifier (required), session_name (required), drivers (required).

get_championship_standingsC

Get Formula One championship standings

Inputs: year (required), round_num.

get_driver_infoC

Get information about a specific Formula One driver

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required).

get_event_infoB

Get detailed information about a specific Formula One Grand Prix

Inputs: year (required), identifier (required).

get_event_scheduleA

Get Formula One race calendar for a specific season

Inputs: year (required).

get_session_resultsC

Get results for a specific Formula One session

Inputs: year (required), event_identifier (required), session_name (required).

get_telemetryC

Get telemetry data for a specific Formula One lap

Inputs: year (required), event_identifier (required), session_name (required), driver_identifier (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    All 8 tools target distinct aspects of Formula One data—drivers, events, sessions, championships, and telemetry—with no overlapping functionality. Each has a clear, non-redundant purpose.

    Naming Consistency5/5

    Every tool uses a consistent verb_noun pattern with lowercase and underscores (e.g., get_driver_info, analyze_driver_performance). The naming is predictable and adheres to a single convention.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its domain. It covers essential F1 operations without being too sparse or overly granular, making it ideal for most common queries without excessive complexity.

    Completeness4/5

    The tool set covers major areas: driver info, performance analysis, comparisons, standings, event details, schedule, session results, and telemetry. One minor gap is lack of team/constructor info, but the surface is otherwise comprehensive for a dedicated F1 server.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical Formula 1 racing data through the Model Context Protocol, offering access to timing data, driver stats, race results, telemetry, and more.
      14
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that provides comprehensive Formula One racing data, enabling access to event schedules, driver information, telemetry data, race results, and performance analytics through natural language queries.
      8
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Formula 1 data via the FastF1 library. Ask Claude (or any MCP-compatible client) about race results, lap times, telemetry, standings, pit stops, and qualifying — with historical data back to 1950 via the Ergast API.
      21
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A local MCP server that gives Claude (or any MCP-compatible AI client) access to Formula 1 race data. Load any session from 2018 onwards, ask questions in natural language, and get answers backed by real telemetry, timing, and strategy data.
      17
      1
      MIT