MCP F1

🚀 F1 MCP Server

FastF1 Pythonパッケージを使用して、フォーミュラ1のデータを提供するモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• 任意のF1シーズンのレーススケジュールを取得
• セッション結果（練習、予選、レース）を取得
• ラップタイムとテレメトリデータにアクセス
• ドライバーとコンストラクターの順位表
• サーキット情報

🚀 クイックスタート

前提条件

• Python 3.13
• uv パッケージマネージャー

1. uvをインストールする（未インストールの場合）

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. F1 MCPサーバーをセットアップする

# クイックセットアップ
./quick-start.sh

# または手動で
make install
# または: uv sync && uv pip install -e .

3. サーバーを起動する

# MCPモード（MCPインスペクター用）
make mcp

# HTTPモード（OAuthテスト用）  
make http

# MCPインスペクターで
make inspector

MCPインスペクターのセットアップ

MCPインスペクターは、MCPサーバーのテストとデバッグに強力なツールです。以下はセットアップ方法です。

1. Node.jsをインストールする（未インストールの場合）

# Homebrewを使用したmacOS
brew install node

# または https://nodejs.org/ からダウンロード

2. MCPインスペクターをインストールする

# npmでグローバルにインストール
npm install -g @modelcontextprotocol/inspector

# インストールを確認
mcp-inspector --version

3. MCPインスペクターでF1 MCPサーバーを起動する

# makeコマンドを使用する（推奨）
make inspector

# または手動で
mcp-inspector uv run python -m f1_mcp_server.server

4. MCPインスペクターの使用方法

起動すると、インスペクターは以下のことを行います。

1. Webインターフェースを起動する（通常は http://localhost:5173）
2. F1 MCPサーバーに自動的に接続する
3. 利用可能なすべてのツールをテストするためのインタラクティブなUIを提供する

インスペクターで利用可能なF1ツール:

• get_race_schedule - F1レースカレンダーを閲覧
• get_session_results - レース/予選の結果を表示
• get_driver_standings - チャンピオンシップの順位表を確認
• get_constructor_standings - チームチャンピオンシップのデータ
• get_lap_times - 特定のセッションのラップタイムを取得

5. インスペクターでの使用例

MCPインスペクターでこれらのサンプルリクエストを試してみてください。

2024年のレーススケジュールを取得する:

{
  "year": 2024
}

モナコGPのレース結果を取得する:

{
  "year": 2024,
  "round_number": 8,
  "session": "R"
}

ヴェルスタッペンのラップタイムを取得する:

{
  "year": 2024,
  "round_number": 1,
  "session": "R",
  "driver": "VER"
}

MCPインスペクターのトラブルシューティング

インスペクターが起動しない場合:

# Node.jsのバージョンを確認する（16以上が必要）
node --version

# インスペクターを再インストールする
npm uninstall -g @modelcontextprotocol/inspector
npm install -g @modelcontextprotocol/inspector

サーバーの接続に問題がある場合:

# まず直接サーバーをテストする
make test-startup

# インスペクターなしでサーバーが起動するか確認する
make mcp

ポートの競合がある場合:

# インスペクターはデフォルトでポート5173を使用します
# そのポートを使用しているプロセスをすべて終了する
lsof -ti:5173 | xargs kill -9

MCPインスペクターでの使用方法

MCPインスペクターは、F1データツールをテストするためのWebベースのインターフェースを提供します。

# MCPインスペクターをインストールする（Node.jsが必要）
npm install -g @modelcontextprotocol/inspector

# インスペクターでF1サーバーを起動する
make inspector

# または手動で
mcp-inspector uv run python -m f1_mcp_server.server

インスペクターの機能:

• http://localhost:5173 のインタラクティブなWeb UI
• リアルタイムのF1データテスト
• JSONスキーマの検証
• ツールのドキュメントブラウザー

💻 使用例

基本的な使用法

利用可能なツールは以下の通りです。

• get_race_schedule: 特定のシーズンのレーススケジュールを取得
• get_session_results: 特定のセッションの結果を取得
• get_driver_standings: ドライバーチャンピオンシップの順位表を取得
• get_constructor_standings: コンストラクターチャンピオンシップの順位表を取得
• get_lap_times: 特定のセッションのラップタイムを取得