F1 Data Server

F1 MCP サーバー

Claude Desktop との連携に向けて、包括的な Formula 1 データと分析を提供する Model Context Protocol（MCP）サーバーです。

機能

このサーバーは、F1 データにアクセスするための 36 個以上のツールを公開します。

レースデータ

• レース結果と順位
• スプリントレースの結果
• 予選の進行状況（Q1、Q2、Q3）
• グリッド順位とフィニッシュ順位の比較
• DNF リストとリタイアの理由

テレメトリーと分析

• ドライバー間の速度トレース比較
• ギアシフトの可視化
• ブレーキとスロットルの分析
• RPM とエンジンデータ
• DRS の使用パターン

タイミングとラップ

• セクタータイム付きの最速ラップデータ
• ラップごとのタイミング
• 削除されたラップ（トラックリミット）
• ラップの安定性に関する統計
• 自己ベストラップ

戦略

• タイヤコンパウンドの分析
• スティントの内訳
• ピットストップデータと最速ストップ
• スタート時のタイヤ選択
• 戦略の比較

順位と履歴

• ドライバー選手権の順位
• コンストラクターズの順位
• 過去のレース優勝者
• コースレコード

ライブデータ

• ライブセッションのステータス
• リアルタイムの順位
• ライブのラップタイム
• ライブテレメトリー
• 現在の気象状況

その他

• チームラジオへのリンク
• レースコントロールからのメッセージ
• トラックのステータス（旗、セーフティカー）
• 気象データ
• サーキット情報

インストール

前提条件

• Python 3.10 以上
• Claude Desktop

セットアップ

1. このリポジトリをクローンします。

git clone https://github.com/drivenrajat/f1.git
cd f1

2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 依存関係をインストールします。

pip install -e .

Claude Desktop の設定

このサーバーを Claude Desktop の MCP 設定に追加します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "f1": {
      "command": "python",
      "args": ["/path/to/f1/f1_server.py"]
    }
  }
}

uv を使用する場合は、次のように設定します。

{
  "mcpServers": {
    "f1": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/f1", "python", "f1_server.py"]
    }
  }
}

使用方法

設定が完了すると、Claude に次のような質問をできます。

• 「2024 年の F1 カレンダーを表示して」
• 「2024 年のモナコ GP のレース結果を取得して」
• 「シルバーストンの予選で、フェルスタッペンとノリスのテレメトリーを比較して」
• 「スパでのハミルトンのタイヤ戦略は？」
• 「現在のドライバー順位を表示して」
• 「イタリア GP の最速ピットストップを取得して」

データソース

• FastF1：過去のテレメトリー、ラップタイム、セッションデータ
• Ergast API：選手権の順位と過去の結果
• OpenF1 API：チームラジオの録音

キャッシュ

このサーバーは、繰り返しのクエリに対するパフォーマンスを向上させるため、FastF1 のデータを cache ディレクトリに自動的にキャッシュします。

ライセンス

MIT ライセンスです。詳細は LICENSE を参照してください。

コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。