F1 MCP Server

🚀 一级方程式 MCP サーバー

このサーバーは、一級方程式レースのデータを提供するモデルコンテキストプロトコル (MCP) サーバーです。様々なツールを提供し、レースカレンダー、ドライバー情報、テレメトリデータ、レース結果を照会できます。

🚀 クイックスタート

コマンドラインでの使用

# サーバーを起動
python -m f1_mcp_server.start

# コンソールにアクセス
python -m f1_mcp_server.console

Python API の使用例

from f1_mcp_server import F1MCPClient

client = F1MCPClient()
print(client.get_circuit())

✨ 主な機能

• レースカレンダー: 任意のシーズンの一級方程式レースカレンダーを取得します。
• レース情報: 特定のグランプリの詳細データを取得します。
• セッション結果: レース、予選、スプリントレース、練習会の包括的な結果を確認できます。
• ドライバー情報: 特定のセッションにおけるドライバーの詳細情報を照会します。
• パフォーマンス分析: 特定のセッションにおけるドライバーのパフォーマンスを分析し、ラップタイム統計を含みます。
• ドライバー比較: 異なるドライバーのレースでのパフォーマンスを比較します。
• テレメトリデータ: リアルタイムのサーキットデータと車両の状態を取得します。

📦 インストール

Smithery を通じてのインストール

uv get package f1-mcp-server

手動インストール

pip を使用したインストール

pip install f1-mcp-server

リポジトリをクローンしてインストール

git clone https://github.com/your-username/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

📚 ドキュメント

プロジェクト構造

• f1_data.py: すべての一級方程式データとのやり取りに関する関数が含まれています。
• server.py: MCP サーバーの核心ロジックを実装しています。
• config.py: デフォルトの設定と環境変数を格納しています。

依存関係

flask==2.0.3
requests==2.26.0

開発環境の設定

仮想環境を作成し、依存関係をインストール

uv venv
source .venv/bin/activate  # Windows ユーザーは .venv\Scripts\activate を使用
pip install -r requirements.txt

品質管理

フォーマットチェック

black .
flake8 .

コードレビュー

bandit run src/

🤝 貢献ガイド

1. リポジトリをクローン

   git clone https://github.com/your-username/f1-mcp-server.git
   cd f1-mcp-server
   

2. 機能ブランチを作成

   git checkout -b feature-name
   

3. 変更をコミット

   git add .
   git commit -m '新機能を追加'
   

4. リモートリポジトリにプッシュ

   git push origin feature-name
   

5. プルリクエストを作成

📄 ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細は LICENSE ファイルを参照してください。

👨‍💻 作者

• Machine To Machine

🙏 謝辞

このプロジェクトは FastF1 という優れた Python ライブラリに依存しています。一級方程式データへのアクセスに使用されています。メンテナーと貢献者の皆様に心から感謝いたします。

このプロジェクトのインスピレーションは rakeshgangwar/f1-mcp-server から得られています。このリポジトリは TypeScript で記述されています。f1_data.py モジュールの大部分はそのソースコードを基にしています。