F1

🚀 F1 MCP サーバー

このサーバーは、Claude Desktop との統合のために、包括的なフォーミュラ1のデータと分析を提供するモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

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

レースデータ

• レース結果と順位
• スプリントレースの結果
• 予選の進行状況（Q1、Q2、Q3）
• グリッド順とゴール順の比較
• 途中棄権リストと棄権理由

テレメトリーと分析

• ドライバー間の速度トレース比較
• ギアシフトの可視化
• ブレーキとスロットルの分析
• 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  # 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 を参照してください。

コントリビュート

コントリビューションは大歓迎です！プルリクエストを送信してください。