Formula One MCP Server (Python)

MIT License
  • Linux
  • Apple

Integrations

  • Enables access to Formula One racing data from a GitHub repository, with the README mentioning the project was inspired by another GitHub repository.

  • Utilizes NumPy as a dependency for working with numerical data in Formula One racing statistics and telemetry analysis.

  • Leverages pandas for data manipulation and analysis of Formula One data, including race results, telemetry, and driver statistics.

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

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

特徴

  • イベントスケジュール: どのシーズンでも完全なF1レースカレンダーにアクセスできます
  • イベント情報:特定のグランプリイベントに関する詳細データ
  • セッション結果: レース、予選セッション、スプリント、練習セッションの総合結果
  • ドライバー情報: 特定のセッションのドライバーの詳細にアクセスします
  • パフォーマンス分析: ラップタイム統計でドライバーのパフォーマンスを分析する
  • ドライバー比較:同じセッションで複数のドライバーのパフォーマンスを比較する
  • テレメトリデータ: 特定のラップの詳細なテレメトリにアクセスします
  • チャンピオンシップ順位表: どのシーズンでもドライバーとコンストラクターの順位表を表示

インストール

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_performanceF1セッションでのドライバーのパフォーマンスを分析する
compare_drivers複数のF1ドライバーのパフォーマンスを比較する
get_telemetry特定のF1ラップのテレメトリデータを取得する
get_championship_standingsF1チャンピオンシップの順位表を見る

基礎データの詳細については、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主にそのソースコードから改変したものです。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

このプロジェクトは、Python FastF1ライブラリを用いて、F1レースデータを提供するモデルコンテキストプロトコル(MCP)サーバーを実装します。既存のTypeScriptサーバーに着想を得て、FastF1を介してPythonで同様のF1データ機能をネイティブに提供します。

  1. Features
    1. Installation
      1. Usage
        1. Command Line
        2. Python API
      2. API Documentation
        1. Dependencies
          1. Development
            1. Setup Development Environment
            2. Code Quality
            3. Contribution Guidelines
          2. License
            1. Authors
              1. Acknowledgements
                ID: qu9jvw5zsv