Pitwall — F1 Data for Claude

Pitwall

Claude を F1 のレースエンジニアにしましょう。
実際のテレメトリー。実際の戦略データ。75 年の歴史。

クイックスタート

Claude Code — 1 つのコマンドで、79 個のツールをすべて利用できます。

claude mcp add pitwall -- uvx --from "f1pitwall[full]" f1pitwall

続いて Claude に質問します：「2025 年のオーストラリア GP の優勝者は？」

uv が必要です（curl -LsSf https://astral.sh/uv/install.sh | sh）。pip も仮想環境も「which python3」も不要で、常に最新リリースを利用できます。

初回起動時は FastF1 スタック（約 540 MB）がダウンロードされ、約 25 秒かかります。その後の起動は毎回 1 秒未満です。初回起動がタイムアウトした場合は、Claude Code を再起動してください。ダウンロードはすでにキャッシュされています。

サーバーと一緒に f1 スキルも使いたい場合は、プラグインとしてインストールできます。Claude Code プラグインとしてインストールをご覧ください。

claude mcp add pitwall -- uvx --from f1pitwall f1pitwall

pip install "f1pitwall[full]"        # or just f1pitwall for lite
claude mcp add pitwall -- f1pitwall

git clone https://github.com/darshjoshi/pitwall.git && cd pitwall
pip install -r requirements.txt        # lite (incl. live timing)
pip install -r requirements-full.txt   # full
claude mcp add pitwall -- python3 $(pwd)/pitwall.py

Claude Code プラグインとしてインストール

このプラグインには、MCP サーバーと f1 スキルの両方が含まれています。スキルは、79 個のツールのうちどれを使うべきか、またレースを見たことがない人に F1 をどう説明するかを Claude に教えます。

/plugin marketplace add darshjoshi/pitwall
/plugin install pitwall@pitwall

Claude Desktop

claude_desktop_config.json に追加します（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "pitwall": {
      "command": "uvx",
      "args": ["--from", "f1pitwall[full]", "f1pitwall"]
    }
  }
}

Pitwall を選ぶ理由

Claude はトレーニングデータから F1 の知識を得ていますが、先週のレースを調べることはできません。ターン 1 を通過するフェルスタッペンのスロットルトレースを表示することも、誰が先にピットインしたか、セーフティカーがいつ出動したかを知ることもできません。

Pitwall は Claude を実際の F1 データに接続します。

• 幻覚ではなく実データ — formula1.com の実際のタイミングフィード
• ラップ単位のテレメトリー — 車両ごとに 4 Hz で記録された速度、RPM、スロットル、ブレーキ、ギア、DRS
• ビジュアルプロット — スピード推移の比較、ギアシフトマップを画像で返します
• 75 年の歴史 — 1950 年以降のすべてのレース結果と選手権
• 各セッション終了後に更新 — 2018 年以降の全テレメトリーとタイミングが、各セッション終了から約 30 分後に公開されます
• API キー不要 — コアデータはすべて無料で、アカウントも必要ありません

質問できること

"Who won the 2025 Australian GP?"           → Race results and classification
"Verstappen's speed on lap 25 at Monaco"    → Lap telemetry at 4Hz
"Plot Hamilton vs Norris speed trace"       → Visual speed comparison chart
"Compare Ferrari's tyre strategy"           → Stint-by-stint breakdown
"Who won the 1994 championship?"            → 75 years of history
"When was the safety car at Silverstone?"   → Race control messages and flags

機能

2つのモードで79個のツールを利用できます。Pitwallはインストール済みの機能を自動検出するため、設定を変更する必要はありません。

Lite モード（30個のツール）

pip install f1pitwall — 軽量な依存関係のみ（mcp、requests、ライブタイミング用のwebsockets／aiohttp）。pandas／numpy／FastF1は不要です。

レース結果、ラップタイム、テレメトリー、タイヤ戦略、ピットストップ、天候、レースコントロール、スピードトラップ、ドライバー比較、および1950年までさかのぼる過去のデータを利用できます。さらに、16個のライブタイミングツール（走行順、ギャップ、ラップ／セクタータイム、タイヤ、天候、レースコントロール、スピードトラップ、ミニセクターなど）も利用でき、セッション中にF1のリアルタイムSignalRフィードを読み取ります。認証は不要です。（ライブの車両テレメトリーとGPSは認証が必要で、Fullモードで利用できます。）F1の無料の静的アーカイブとJolpica APIを使用します。

Full モード（79個のツール）

pip install -r requirements-full.txt — FastF1が追加されます。

Liteモードのすべてに加えて、次の機能を利用できます。

セットアップ

claude mcp add pitwall -- python3 /absolute/path/to/pitwall.py

{
  "mcpServers": {
    "pitwall": {
      "command": "python3",
      "args": ["/absolute/path/to/pitwall.py"]
    }
  }
}

where python

claude mcp add pitwall -- python C:\Users\YourName\Projects\pitwall\pitwall.py

{
  "mcpServers": {
    "pitwall": {
      "command": "python",
      "args": ["C:\\Users\\YourName\\Projects\\pitwall\\pitwall.py"]
    }
  }
}

claude mcp add pitwall -- python3 /absolute/path/to/pitwall.py

{
  "mcpServers": {
    "pitwall": {
      "command": "python3",
      "args": ["/absolute/path/to/pitwall.py"]
    }
  }
}

セットアップ後、Claude Code または Claude Desktop を再起動してください。MCP 互換のクライアントであれば、どれでも利用できます。

オプション：初心者向けスキル（Claude Desktop）

SKILL.md を Claude Desktop のスキルとしてアップロードします（Settings → Skills → Upload）。Claude が DRS、アンダーカット、コンパウンド、セーフティカーなど、F1 の専門用語をその場で解説します。

データソース

主要なデータはすべて無料で、API キーも不要です。

仕組み

Pitwall は F1 が公開している静的なタイミングアーカイブからデータを読み込みます。これは公式 F1 アプリを支えるデータと同じものです。各セッション終了後（約30分）に、F1 はセッションごとに33種類のデータフィードを公開します。これには、車両の完全なテレメトリー（車両ごとに約4Hzの速度、RPM、スロットル、ブレーキ、ギア、DRS）、GPS 位置、タイヤデータ、ピットストップ、レースコントロールのメッセージが含まれます。

テレメトリーツール（get_telemetry）は、タイミングストリームと車両データストリームを関連付け、特定のドライバーの特定のラップのテレメトリーを抽出します。これを実現する F1 MCP サーバーはほかにありません。

アーキテクチャ

Claude ──MCP──> Pitwall ──HTTP──> livetiming.formula1.com/static/ (free)
                       ──HTTP──> api.jolpi.ca/ergast/f1/ (free)
                       ──lib──>  FastF1 (optional, local)
                       ──WS───> SignalR Core (optional, live races)

サーバーの実行

python3 pitwall.py              # MCP stdio (Claude Code / Claude Desktop)
python3 pitwall.py --http       # MCP HTTP (remote / self-hosted)
python3 pitwall.py --http --port 3000

ライブレースデータ

Pitwallには、F1セッション開催中のリアルタイムデータを取得するための、生のSignalR Core WebSocketクライアントが含まれています。ほとんどのデータは無料です。車両テレメトリーとGPSの取得には、F1 TV ProまたはPremiumのサブスクリプションが必要です。

注： get_live_* MCPツールは、このクライアントのSignalRライブフィードを直接読み取ります。16個のタイミングツール（順位、ギャップ、ラップ／セクタータイム、タイヤ、天候、レースコントロール、スピードトラップ、ミニセクターなど）は、liteインストールで認証なしで動作します。ライブの車両テレメトリーとGPS（get_live_telemetry、get_live_gps_positions）にはF1 TVトークンが必要で、fullインストールに含まれます。セッション終了後も、テレメトリー、タイミング、戦略などのセッション後データは、メインツールから引き続き利用できます。

python3 auth_setup.py

import asyncio
from signalr_client import F1LiveClient

async def main():
    # Free mode — timing, weather, race control (no auth needed)
    client = F1LiveClient(no_auth=True)

    @client.on("TimingData")
    def on_timing(data, timestamp):
        for num, info in data.get("Lines", {}).items():
            print(f"P{info.get('Position','?')} #{num} Gap: {info.get('GapToLeader','')}")

    @client.on("RaceControlMessages")
    def on_rc(data, timestamp):
        for msg in data.get("Messages", {}).values():
            print(f"[{msg.get('Flag', '')}] {msg.get('Message', '')}")

    await client.connect()

asyncio.run(main())

from auth_setup import load_token

client = F1LiveClient(no_auth=False, auth_token=load_token())

@client.on("CarData.z")
def on_telemetry(data, timestamp):
    # Speed, RPM, throttle, brake, gear, DRS at ~4Hz per car
    ...

@client.on("Position.z")
def on_position(data, timestamp):
    # GPS X/Y/Z coordinates at ~4Hz per car
    ...

リファレンス

レース名

レース名はあいまい一致で照合されます。以下の名前はすべて使用できます。

"china", "chinese", "shanghai"           → Chinese Grand Prix
"australia", "melbourne", "aus"          → Australian Grand Prix
"monaco", "monte carlo"                  → Monaco Grand Prix
"silverstone", "great britain", "british" → British Grand Prix

ドライバーコード

VER = Verstappen    HAM = Hamilton    NOR = Norris     LEC = Leclerc
ANT = Antonelli     RUS = Russell     PIA = Piastri    BEA = Bearman
GAS = Gasly         LAW = Lawson      HAD = Hadjar     SAI = Sainz
ALO = Alonso        STR = Stroll      OCO = Ocon       BOT = Bottas
ALB = Albon         HUL = Hulkenberg  COL = Colapinto  LIN = Lindblad

プロジェクトファイル

コントリビューション

バグを見つけましたか？ツールを追加したいですか？コントリビューションを歓迎します。

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. テストスイートを実行します：python3 tests/pitwall_tool_validation.py
5. プルリクエストを作成します

クレジット

• FastF1 — @theOehrlyによる、F1向けPythonライブラリの最高峰
• Jolpica-F1 — Ergast APIの後継
• drivenrajat/f1 — FastF1のツールパターンの着想元

開発者

Darsh Joshi — AIエンジニア

ライセンス

MIT