Nflverse

@pipeworx/nflverse

nflverse が提供する、1999 年から現シーズンまでの NFL のプレーごとのデータ、選手のシーズン統計、チームの試合ログ、結果とベッティングラインを含む日程、毎週の負傷レポートです。

Pipeworx の一部です。AI エージェントを 1779 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、承認も受けておらず、公開もされていません。

ツール

• nfl_player_season_stats(player, season, season_type?)：選手 1 人のシーズン通算成績（パス、ラン、レシーブ、ディフェンス、キック、リターン、EPA、CPOE、ターゲットシェア、ファンタジーポイント）。名前または nflverse／GSIS ID で検索します。値が 0 のフィールドは省略されます。
• nfl_team_game_log(team, season)：1 シーズン分のチームの試合一覧です。各試合には、対戦相手、ホーム／アウェイ、最終スコア、勝敗、パス、ラン、EPA、ターンオーバー、反則、サック、キックの合計が含まれます。
• nfl_play_by_play(game_id, quarter?, play_type?, limit?)：1 試合の全プレーを取得します。ダウンと距離、フィールド位置、プレータイプ、獲得ヤード、公式のプレー説明、関与した選手、スコア、EPA、勝率が含まれます。
• nfl_schedule(season, week?, team?)：1 シーズンの試合一覧です。各試合には ID、日付、キックオフ時刻、スコア、延長戦、確定時のスプレッドと合計、会場、屋根とフィールドの種類、天候、先発 QB、コーチ、審判が含まれます。
• nfl_injuries(season, team?, week?, player?)：公式の毎週の負傷レポート項目（試合出場状況と練習参加状況）を、最新の週から順に取得します。2009 年から現シーズンまでを対象としています。

すべての応答には data_as_of が含まれます。これは、回答の取得元となった nflverse のシーズンファイルの最終更新時刻です。また、source と licence も含まれます。一致する検索結果がない場合は、メッセージとともに found: false が返されます。不明なチームコードや形式が不正な試合 ID は、正しい形式を列挙したエラーとともに拒否されます。

認証

キーは不要です。

データソース

• nflverse、nflverse-data：プレーごとのデータ、選手とチームの統計、日程、負傷レポート。nflverse プロジェクトが NFL の試合データから編集しています。

ライセンス。 nflverse-data リポジトリは Creative Commons Attribution 4.0 International (CC-BY-4.0) のもとで公開されています。商用利用を含む再利用が、クレジット表記付きで許可されています。すべての応答には licence: "CC-BY-4.0 — data by nflverse (https://github.com/nflverse)" が含まれます。各呼び出しでは、リクエスト時点で公開されているシーズンファイルを読み込みます。このパックはコピーを保持しません。

次の担当者へのメモ：

• チームコードは nflverse の規則に従います。LA は Rams を表します（LAR も別名として受け付けます）。LAC、LV、WAS も使用します。移転前のフランチャイズは、過去のシーズンでは旧コード（OAK、SD、STL）を引き続き使用します。
• シーズンは 9 月から翌年 2 月までです。そのため、2024 シーズンには 2025 年に行われたプレーオフの試合も含まれます。
• プレーごとのデータは大きなテーブルで、1 シーズンあたり gzip 圧縮時で約 19 MB、CSV で約 100 MB です。ストリーミングで読み込み、1 試合分に絞り込みます。行は game_id 順に並んでいるため、要求された試合を過ぎるとスキャンを終了します。
• 現シーズンのファイルはシーズン中に nflverse が更新するため、data_as_of も更新に合わせて変わります。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "nflverse": {
      "url": "https://gateway.pipeworx.io/nflverse/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/nflverse/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、共有ツールが約 30 個表示されます。接続時の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の正式な情報となります。

これは意図的な仕様であり、誤って多重化されているわけではありません。メタツールを使うと、このパックの対象外の質問にも、全カタログを横断してルーティングする ask_pipeworx を介して回答できるため、2 つ目の MCP サーバーを追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1779 件以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/nfl_player_season_stats \
  -H 'Content-Type: application/json' \
  -d '{"player":"Joe Burrow","season":2024}'

最初の呼び出しにはアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/nfl_player_season_stats を呼び出します。ツールを探すには、POST https://gateway.pipeworx.io/v1/tools/search_packs に {"query":"..."} を指定して呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "nflverse": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nflverse"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-nflverse

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Nflverse data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT