RaceHooks

Name: RaceHooks
Author: racehooks

ローカル

racehooks.ioゲーム・エンタメ11 日前に更新

リポジトリ公式サイト

RaceHooks について

RaceHooksは、F1の分析、ライブタイミング、アカウント操作をAIアシスタントから利用するためのMCPサーバーです。レースやテレメトリーのデータに加え、Webhook、利用状況、セッション再生を扱えます。

主な機能

01ライブセッションの計時とイベント日程
02レース結果、戦略分析、テレメトリー
03ドライバー、コンストラクター、サーキット、シーズンの履歴
04Webhookの作成、テスト、配信ログ
05プラン、請求、利用状況の指標
06録画セッションの再生ツール

活用シーン

01現在のセッション状況と計時の確認
02ドライバーの成績とタイヤ劣化の比較
03レースデータ用Webhookの作成と監視
04配信使用量の確認と録画セッションの再生

MCP 対応

MCPツール、読み取り専用リソース、ガイド付きプロンプトを通じてRaceHooksのアカウントデータを提供します。設定したアカウント認証情報を使用し、利用できるデータはプランによって異なります。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "racehooks-racehooks": {
      "command": "npx",
      "args": [
        "-y",
        "@racehooks/mcp"
      ],
      "env": {
        "RACEHOOKS_CLIENT_ID": "<RACEHOOKS_CLIENT_ID>",
        "RACEHOOKS_CLIENT_SECRET": "<RACEHOOKS_CLIENT_SECRET>",
        "RACEHOOKS_BASE_URL": "<RACEHOOKS_BASE_URL>"
      }
    }
  }
}

起動コマンドnpx -y @racehooks/mcp

設定が必要な環境変数

RACEHOOKS_CLIENT_IDYour RaceHooks client ID. Get yours at racehooks.io.

RACEHOOKS_CLIENT_SECRETシークレットYour RaceHooks client secret.

RACEHOOKS_BASE_URLAPI base URL. Defaults to https://api.racehooks.io.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@racehooks/mcp0.4.1stdio

ツール

掲載時のツール一覧 · 1 週間前に更新

パラメーター	型	必須	説明
limit	integer	いいえ

詳細

@racehooks/mcp

RaceHooks 用の MCP サーバーです。AI アシスタント（Claude、Cursor、Windsurf）から、RaceHooks のモータースポーツ分析データに直接アクセスできます。

RaceHooks は独立したサービスであり、Formula One Management または FIA と提携・承認関係にはありません。「Formula 1」、「F1」および関連する商標は、Formula One Licensing BV の商標です。

できること

RaceHooks アカウントを AI アシスタントに公開し、58 個のツール、7 個のリソース、6 個のガイド付きプロンプトを利用できるようにします。すべての呼び出しはアカウントの認証情報を使って行われるため、ツールの戻り値はご利用のプラン（Free、Developer、または Custom）によって異なります。データツールは Formula 1 を対象としています。

ツール

ライブ

ツール	内容	主な引数	プラン
`get_live_session`	現在のセッション状態：フラッグ、ラップ、順位、タイム差、タイヤ、レースコントロールメッセージ。ライブ中のセッションがない場合は空です。	—	全プラン（Free ではライブタイミングの代わりに最新のマイルストーン分類を取得）
`list_events`	セッションスケジュールとステータスを含むレースウィークエンド。	`year`、`upcoming`、`limit`	全プラン

レース後の分析

ツール	内容	主な引数	プラン
`list_insight_races`	レース後の分析一式が完成しているレース。	`season`	全プラン
`get_race_insights`	ドライバー別・ラップ別のモデル出力（ピット、セーフティカー、オーバーテイク、アンダーカット、タイヤの状態、性能低下リスク、LTOE、優勝確率、予想ポイント）に加え、ピットストップ、スティント、ラップタイムを取得します。	`raceId`	全プラン（Free ではタイヤの状態のみ。戦略予測には Developer 以上が必要）
`get_model_meta`	公開モデルマニフェスト：各モデルの予測内容、モデルファミリー、キャリブレーション階層、最終学習日。	—	全プラン
`get_session_analytics`	セッションのラップ別分析スナップショット。	`sessionId`	Developer 以上
`get_race_summary`	レース後の分析ステータスとテレメトリーの集計指標。	`raceId`	全プラン（集計データには Developer 以上が必要）

レース

ツール	内容	主な引数	プラン
`get_race`	結果と予選グリッドを含むレースの詳細。	`raceId`	全プラン（タイミングフィールドには Developer 以上が必要）
`get_race_qualifying`	予選結果。	`raceId`	全プラン（Q1／Q2／Q3 のタイムには Developer 以上が必要）
`get_race_pitstops`	ピットストップ記録（ドライバー、ストップ回数、ラップ、所要時間）。	`raceId`	全プラン
`get_race_tyres`	タイヤのスティント（コンパウンド、ラップ範囲、タイヤ使用年数）。	`raceId`	全プラン
`get_race_weather`	ラップごとの天候。	`raceId`	全プラン
`get_race_laps`	ラップごとのタイムと順位。	`raceId`、`driverId`	Developer 以上
`get_event_pace`	ドライバー別のフリー走行・予選ペースの概要。	`eventId`	Developer 以上

履歴（ドライバー、コンストラクター、サーキット、シーズン）

ツール	内容	主な引数	プラン
`list_drivers`	検索可能なドライバー一覧です。	`search`、`nationality`、`active`、`limit`、`offset`	すべて（ページサイズはFreeで25、Paidで100）
`get_driver`	キャリア統計付きのドライバープロフィールです。	`driverId`	すべて
`get_driver_results`	ドライバーのレースごとの結果です。	`driverId`、`season`	すべて（タイミング項目にはDeveloper+が必要です）
`get_driver_standings`	ドライバーのチャンピオンシップ順位の履歴です。	`driverId`、`season`	すべて
`list_constructors`	コンストラクター一覧です。	`lineage`、`active`、`limit`、`offset`	すべて
`get_constructor`	系譜の履歴付きコンストラクタープロフィールです。	`constructorId`	すべて
`get_constructor_results`	コンストラクターのレースごとの結果です。	`constructorId`、`season`	すべて（タイミング項目にはDeveloper+が必要です）
`get_constructor_standings`	コンストラクターのチャンピオンシップ順位の履歴です。	`constructorId`、`season`	すべて
`list_circuits`	所在地付きのサーキット一覧です。	`country`、`limit`、`offset`	すべて
`get_circuit`	サーキットの詳細と分析情報です。	`circuitId`	すべて
`list_seasons`	レース数付きのシーズン一覧です。	—	すべて
`get_season_standings`	シーズンの最終ドライバー順位とコンストラクター順位です。	`year`	すべて
`get_season_races`	シーズン中のレース一覧です。	`year`	すべて

テレメトリー

ツール	内容	主な引数	プラン
`get_telemetry_laps`	ラップごとのテレメトリー集計（速度、スロットル、ブレーキ、DRS、アグレッション）です。	`raceId`、`driverId`、`lapNumber`	Developer+
`get_telemetry_driver_laps`	1人のドライバーのラップごとのテレメトリーです。	`raceId`、`driverId`	Developer+
`get_telemetry_lap_comparison`	1周分の全ドライバーのテレメトリーです。	`raceId`、`lapNumber`	Developer+
`get_telemetry_race_summary`	レース単位のテレメトリー概要です。	`raceId`	Developer+
`get_race_telemetry_laps`	レースデータ API のラップごとのテレメトリー指標です。	`raceId`、`driverId`	Developer+
`get_race_telemetry_stints`	スティントごとのテレメトリーと劣化傾向です。	`raceId`、`driverId`	Custom
`get_race_telemetry_aggression`	ドライバーのアグレッション指数ランキングです。	`raceId`	Custom

ファンタジー

ツール	内容	主な引数	プラン
`get_fantasy_scores`	ドライバーごとのF1 Fantasy推定ポイントと詳細な内訳です。	`raceId`	Developer+
`get_fantasy_pit_times`	セッションのピットストップ時間（静止時間）ランキングです。	`sessionId`	Developer+

アカウント、使用状況、Webhook

ツール	内容	主な引数	プラン
`list_feeds`	各フィードに必要なプランを含むフィード一覧です。	`limit`	すべて
`list_webhooks`	アカウントのWebhookサブスクリプション一覧です。	`limit`、`offset`	すべて
`get_webhook`	IDで指定したWebhookです。	`webhookId`	すべて
`create_webhook`	Webhookを作成します。署名シークレットは一度だけ返されます。	`feedId`、`webhookUrl`、`webhookMethod`、`filters`	すべて
`update_webhook`	URL、メソッド、フィルターを変更します。`active`で一時停止／再開します。	`webhookId`、`webhookUrl`、`filters`、`active`	すべて
`delete_webhook`	Webhookを削除します。	`webhookId`	すべて
`test_webhook`	テストペイロードをすぐに送信します。	`webhookId`	すべて
`get_webhook_logs`	最近の配信ログです。	`webhookId`、`limit`	すべて
`get_webhook_secret`	現在の署名シークレットです。	`webhookId`	すべて
`rotate_webhook_secret`	署名シークレットをローテーションします（古いシークレットはただちに使えなくなります）。	`webhookId`	すべて
`get_subscription`	ティア、プランの上限、使用状況のスナップショットです。	—	すべて
`get_usage`	今期の配信数と失敗数、残りの利用枠です。	—	すべて
`get_usage_by_feed`	今期のフィードごとの配信数です。	—	すべて
`get_usage_latency`	フィードごとの配信遅延パーセンタイルです。	—	すべて
`get_usage_hourly`	過去24時間の時間ごとの配信数です。	—	すべて
`get_usage_history`	過去の期間にわたる配信履歴です。	—	すべて
`get_billing_plan`	現在のプラン、上限、今期の使用状況、請求期間の日付です。	—	すべて

セッションリプレイ

ツール	機能	主な引数	プラン
`list_replay_sessions`	再生可能な録画済みセッションを一覧表示します。	`year`、`type`、`limit`、`offset`	すべて（Free と Developer は現行シーズンのみ）
`get_demo_session`	再生用に選定されたデモセッションを取得します。	—	すべて
`get_replay_quota`	ご利用プランの再生配信クォータ（セッション数の上限）を取得します。	—	すべて
`prepare_replay`	セッションの再生アーティファクトを準備します。	`sessionId`	すべて
`get_replay_status`	セッションの再生アーティファクトが準備できているか確認します。	`sessionId`	すべて

リソース（読み取り専用のコンテキスト）

racehooks://feeds — フィードカタログ全体
racehooks://live — 現在のライブセッションの状態
racehooks://webhooks — すべての Webhook サブスクリプション
racehooks://usage — 現在の配信使用量
racehooks://drivers — 現行シーズンのドライバー名簿
racehooks://circuits — 所在地付きのサーキット一覧
racehooks://seasons — レース数付きのシーズン一覧

プロンプト（ガイド付きワークフロー）

setup_race_event_webhook — フィルターを設定して events.race サブスクリプションを作成します
setup_fantasy_scoring_webhook — ファンタジー向けに最適化されたサブスクリプションを作成します
check_account_health — アカウントの健全性を包括的に要約します
analyze_race_strategy — 1 レースのピット戦略、タイヤ管理、モデル予測を分析します
compare_drivers — 1 レースで 2 人のドライバーを直接比較します
explain_ml_predictions — 直近の分析済みレースでモデルが予測した内容と実際の結果を説明します

インストール

npm install -g @racehooks/mcp

または、npx で直接実行します。

npx @racehooks/mcp

API 認証情報は racehooks.io で取得してください。

設定

2 つの環境変数が必要です。設定されていない場合、サーバーは起動時に終了します。

export RACEHOOKS_CLIENT_ID="your-client-id"
export RACEHOOKS_CLIENT_SECRET="your-client-secret"
# Optional — defaults to https://api.racehooks.io
export RACEHOOKS_BASE_URL="https://api.racehooks.io"

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "racehooks": {
      "command": "npx",
      "args": ["-y", "@racehooks/mcp"],
      "env": {
        "RACEHOOKS_CLIENT_ID": "your-client-id",
        "RACEHOOKS_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

Claude Code は .claude/settings.json から MCP サーバーを読み込みません。CLI でサーバーを追加します。

claude mcp add racehooks \
  -e RACEHOOKS_CLIENT_ID=your-client-id \
  -e RACEHOOKS_CLIENT_SECRET=your-client-secret \
  -- npx -y @racehooks/mcp

--scope project を追加すると、プロジェクト内の共有 .mcp.json に書き込まれます。--scope user を追加すると、すべてのプロジェクトで利用できるようになります。シークレットをコミットせずにファイルをチェックインするには、.mcp.json で環境変数を参照します。

{
  "mcpServers": {
    "racehooks": {
      "command": "npx",
      "args": ["-y", "@racehooks/mcp"],
      "env": {
        "RACEHOOKS_CLIENT_ID": "${RACEHOOKS_CLIENT_ID}",
        "RACEHOOKS_CLIENT_SECRET": "${RACEHOOKS_CLIENT_SECRET}"
      }
    }
  }
}

Cursor / Windsurf

MCP 設定（.cursor/mcp.json または同等のファイル）に追加します。

{
  "mcpServers": {
    "racehooks": {
      "command": "npx",
      "args": ["-y", "@racehooks/mcp"],
      "env": {
        "RACEHOOKS_CLIENT_ID": "your-client-id",
        "RACEHOOKS_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Cline

Cline で MCP Servers → Installed → Configure MCP Servers を開き、cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "racehooks": {
      "command": "npx",
      "args": ["-y", "@racehooks/mcp"],
      "env": {
        "RACEHOOKS_CLIENT_ID": "your-client-id",
        "RACEHOOKS_CLIENT_SECRET": "your-client-secret"
      },
      "disabled": false
    }
  }
}

Claude の使用例

設定が完了したら、Claude に次のようなことを尋ねられます。

「RaceHooks アカウントの健全性を確認してください」

「https://myapp.com/hook 用に、Ferrari のみを対象とするフィルターを設定した events.race Webhook を作成してください」

「直近のレースにおける VER と NOR のタイヤ劣化を比較してください」

「今日、最も多くの配信クォータを使用しているフィードを表示してください」

「https://scoring.myapp.com/hook 用に、VER、NOR、LEC のチームのファンタジースコアリング Webhook を設定してください」

セキュリティ

MCP サーバーはローカルの stdio プロセスとして実行され、ネットワークポートを開くことはありません。認証情報は環境変数経由で渡され、アクセストークンを取得するために RaceHooks API にのみ送信されます。ツール呼び出しやリソース URI に認証情報が含まれることはありません。

すべての API 呼び出しは OAuth 2 クライアント認証情報を使用して認証されます（トークンは有効期限前に自動更新されます）。

リンク

Markdown 対応

ログインしてコメント

基本情報

作者: racehooks
言語: node
バージョン: 0.4.1
トランスポート: stdio
掲載日: 2026年10月21日
最終更新: 1 日前
公式 Registry: io.github.racehooks/racehooks-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。