Open Formula 1 Mcp Server

Open-F1-MCP-Server

このプロジェクトは、Open Formula 1 用の MCP サーバーを実装しています。

詳しい情報については、Open F1 MCP サーバーの実装をご確認ください。

私は高校生で、自分のプロジェクトが気に入られたり、使われたりしているか知りたいと思っています。この MCP サーバーを気に入ったり、利用したりしている場合は、GitHub でスターを付けて、友人にも共有してください。ありがとうございます！！

Arya Akman

Open Formula 1 とは

Open Formula 1 は、リアルタイムおよび過去の Formula 1 データを提供するオープンソース API です。

この API は、ラップタイム、車両のテレメトリー、無線通信など、豊富な情報を提供します。インタラクティブなダッシュボードを作成したり、レース分析を深く掘り下げたり、お気に入りのドライバーが首位に立つたびに点灯するコネクテッドオブジェクトを開発したりと、OpenF1 ならすべて実現できます。

ツール（v1.2 時点）

get_sessions:

F1 のレースセッションを取得します。年、国、サーキット、セッションタイプなどで絞り込めます。session_key、日付、場所、タイプなどのセッション詳細を返します。

Parameter	        Description
year		        年で絞り込みます（例：2023、2024）。
country_name	    国名で絞り込みます（例：'Monaco'、'Italy'）。
circuit_short_name	サーキットの短縮名で絞り込みます（例：'Monza'、'Monaco'）。
session_name    	セッション名で絞り込みます（例：'Race'、'Qualifying'、'Sprint'）。
session_key	    	一意の session_key で特定のセッションを取得します。
date_start	    	開始日で絞り込みます（ISO 形式：YYYY-MM-DD）。>= や <= などのフィルターに対応しています。
Other filters		session_type、location、country_code、meeting_key、gmt_offset

get_drivers:

ドライバー情報を取得します。現在の全ドライバーを取得するか、session_key で絞り込んで特定のセッションに参加したドライバーを取得できます。名前、番号、チーム、国、ヘッドショットの URL など、ドライバーの詳細を返します。

Parameter	    	Description
session_key	    	任意。session_key でドライバーを絞り込み、特定のセッションの参加者を取得します。
driver_number	   	任意。ドライバー番号で絞り込みます（例：1、44、16）。
team_name        	任意。チーム名で絞り込みます（例：'Red Bull Racing'、'Ferrari'）。

get_laps:

特定のセッション、ドライバー、ラップのラップデータを取得します。ラップタイム、セクタータイム、所要時間、順位など、詳細なラップ情報を返します。

Parameter	    	Description
session_key	    	有用な結果を得るには必須です。一意の session_key で絞り込みます。
driver_number	   	任意。ドライバー番号で絞り込みます（例：1、44、16）。
lap_number	    	任意。特定のラップ番号で絞り込みます。

get_pit_stops:

特定のセッションのピットストップデータを取得します。所要時間、ラップ番号、タイミングなど、詳細なピットストップ情報を返します。

Parameter	        Description
session_key	        有用な結果を得るには必須です。一意の session_key で絞り込みます。
driver_number		任意。ドライバー番号で絞り込みます（例：1、44、16）。
pit_duration		任意。ピットストップ所要時間の上限を秒単位で指定します（例：30.0 は、30 秒未満のストップ）。

get_overtakes:

ドライバー間の順位変動を示すオーバーテイクデータを取得します。オーバーテイクとは、あるドライバー（追い抜く側）が別のドライバー（追い抜かれる側）と順位を入れ替えることです。関係するドライバー、ラップ番号、イベントのタイミングなど、詳細な情報を返します。

Parameter	                Description
session_key	    	        有用な結果を得るには必須です。一意の session_key で絞り込みます。
overtaking_driver_number    オーバーテイクを行ったドライバーの番号で絞り込む任意のパラメーターです（例：1、44）。
overtaken_driver_number		追い抜かれたドライバーの番号で絞り込む任意のパラメーターです（例：16、63）。

インストール手順：

1. 依存関係をインストール：

bashpip install mcp httpx

## 2. Claude デスクトップの設定（claude_desktop_config.json）を追加／更新します：

{
  "mcpServers": {
    "Open-F1": {
      "command": "python",
      "args": ["/path/to/OpenF1MCPServer.py"]
    }
  }
}

3. Claude デスクトップを再起動して、インストールを確認します

Claude Desktop -> File -> Settings -> Developer に移動します

画面右側の「Local MCP Servers」を確認し、以下を確認します。

• 「Open-F1」が表示されている
• 状態が「running」（青色の背景で強調表示）になっている

使用例

以下のプロンプト例を参考に、この MCP サーバーの活用方法を検討できます。

• セッション（レース）関連の使用例

  • 「2024年のF1セッションをすべて表示して」

  • 「2023年モナコのレースセッションの詳細を取得して」

• ドライバー関連の使用例

  • 「セッション9158で走行したのは誰？」（session_key を使用）

  • 「2024年モンツァのレースに出場したフェラーリのドライバーをすべて表示して」

• ラップ情報関連の使用例

  • 「2024年モナコのレースで、すべてのドライバーの10周目のデータを取得して」

  • 「前回のレースでマックス・フェルスタッペンが記録した最速ラップは？」

  • 「セッション9158の1周目について、ドライバー1と44のセクタータイムを比較して」

• ピットストップ関連の使用例

  • 「2025年シンガポールグランプリのピットストップをすべて表示して」

  • 「セッション9158でドライバー1のピットストップを取得して」

  • 「前回のレースで25秒未満のピットストップをすべて見つけて」

  • 「2025年モナコのレースセッションで最速のピットストップを記録したドライバーは？」

  • 「レッドブルとフェラーリのドライバーのピットストップタイムを比較して」

  • 「2025年シンガポールで30秒を超えたピットストップをすべて表示して」

• オーバーテイク関連の使用例

  • 「2024年モナコのレースでのオーバーテイクをすべて表示して」

  • 「セッション9158でドライバー1がほかのドライバーを追い越した回数は？」

  • 「前回のレースでドライバー44を追い越したのは誰？」

  • 「ドライバー16が関与したオーバーテイクをすべて表示して」

  • 「セッション9158でオーバーテイクが最も多かったのは何周目？」

  • 「ドライバー1と16の間のバトルをすべて表示して」（両方のパラメーターを使用できます）

サーバーは OpenF1 への API 呼び出しを処理し、Claude が解釈して表示できる形式でデータを返します。