F1 Mcp Server

🏁 Formula 1 MCP サーバー 🏎️

このプロジェクトでは、Formula 1 データを扱う MCP サーバーを定義しています。ファン、アナリスト、開発者が幅広い F1 の統計情報やデータに簡単にアクセスできます。Python で構築され、Gradio フレームワークを活用しており、FastF1 ライブラリと公式の OpenF1 API から取得した過去および最新の F1 データを閲覧できる、使いやすいウェブインターフェースを提供します。

動画デモ（Claude Desktop）

アーキテクチャ

MCP サーバーとクライアントのアーキテクチャ概要です。MCP サーバーは Gradio バックエンドを使用してホストされ、ローカルまたはリモートサーバー上で実行できます。

Gradio の主な機能

インターフェースは複数の Gradio タブで構成され、それぞれが特定の種類の F1 データに特化しています。

• 選手権順位： 1950 年から現在までの任意のシーズンについて、ドライバーおよびコンストラクターの最終選手権順位を表示します。
• イベント情報： スケジュールやサーキットの詳細など、任意のグランプリに関する詳細情報を取得します。
• シーズンカレンダー： 指定した年のレースカレンダー全体を表示します。
• トラックの可視化： 最速のレースラップのプロットを生成して表示し、速度、ギアチェンジ、コーナリング時の G フォースを可視化します。
• セッション結果： 任意のレースセッション（フリー走行、予選、またはレース）の詳細な結果を取得します。
• ドライバーとコンストラクターの情報： ドライバーやチームの背景情報や統計を検索します。
• OpenF1 API ツール： 開発者が OpenF1 API に直接クエリを送信し、カスタムリクエストを作成して、生の JSON レスポンスを表示できる高度なツールキットです。

技術スタック

• バックエンド： Python
• ウェブフレームワーク： Gradio
• データソース：
  • 過去のデータには fastf1 Python ライブラリを使用します。
  • 公開 API を介したライブおよび最新のデータには openf1 を使用します。
• 主なライブラリ： pandas、matplotlib

MCP サーバー

MCP サーバーは app.py 内で定義されています。

MCP クライアント

MCP クライアントと AI エージェントは mcp_client.py 内で定義されており、サーバー送信イベント（SSE）トランスポートを介して MCP サーバーとやり取りできます。

MCP 設定ファイル

SSE トランスポートに対応する MCP クライアントでは、以下の設定を使用できます（Claude Desktop の場合は、下記を参照してください）。

{
  "mcpServers": {
    "gradio": {
      "url": "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse"
    }
  }
}

Claude Desktop では、代わりに以下の設定を使用できます。ただし、Node.js がインストールされていることを確認してください。

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}