Bts Ontime

@pipeworx/bts-ontime

米国内航空会社の定時運航状況と遅延原因：月ごとの定時到着率、平均到着遅延、欠航、目的地変更、および原因別（航空会社、天候、航空管制／NAS、保安、前便の遅延）遅延時間（路線別、航空会社別、到着空港別）。フリート #2953。

Pipeworx の一部です。AI エージェントを1,779以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとの提携、同社による承認、または同社による公開を受けたものではありません。

ツール

• route_ontime(origin, dest, carrier?, months?) — 1つの出発地から目的地への路線における月ごとの定時運航状況です。必要に応じて航空会社を指定できます。各月について、便数、運航完了便数、定時到着便数と定時到着率、平均到着遅延、欠航、目的地変更、原因別の遅延時間を示します。
• carrier_ontime(carrier, airport?, months?) — 同じ月ごとのデータを、1社の航空会社の全ネットワーク（または1つの空港に発着する便のみ）で集計します。
• bts_airport_delays(airport, year?, month?, limit?, offset?) — 1つの空港に到着する便について、航空会社別に遅延原因を内訳表示します。必要に応じて、年または月を指定できます。limit のデフォルトは50（最大200）です。一致する行が返却件数を超える場合、黙って省略せず、truncated: true と total_matching を返します。
• delay_causes(year, carrier?, airport?, limit?, offset?) — 同じ遅延原因の行を、まず年ごとに整理します。1年分を航空会社別または空港別に確認できます。ページネーションは bts_airport_delays と同じく、limit／truncated／total_matching を使用します。
• list_coverage() — 実際に読み込まれている最古と最新の月、および読み込み時期を返します。対象期間がカバーされているかわからない場合は、最初に呼び出してください。

航空会社は、2文字の報告航空会社コード（"DL"）または一般的な航空会社名（"Delta"）で指定できます。空港コードは静的な一覧ではなく、実際に読み込まれたデータに基づいて検証されます。認識されないコードは、空の成功結果ではなく、明確なエラーを返して拒否されます。

認証

認証キーは不要です。ツールはデータを保持する Pipeworx ゲートウェイ経由でのみ応答します。単独で npm install しても読み取れるデータはなく、どのツールも空のリストを返す代わりに、「not bound in this runtime」という明確なエラーをスローします。

データソース

• 米国運輸省運輸統計局（BTS）、TranStats — 月次一括データ「Reporting Carrier On-Time Performance」。米国連邦政府の業務成果物はパブリックドメインです（17 U.S.C. §105）。同局は一括ファイルのみを公開しており（このデータセットのライブクエリ API はありません）、このパックではプロキシではなく、コピーを作成します（scripts/bts-ontime/load-data.mjs）。生のフライト単位の行（約60万件／月）は保存されません。ローダーは各月を2つの小さなテーブルに集計し、生ファイルを破棄してから次の月に進みます。

delay_cause が示すもの、示さないもの

BTS は「Airline Delay Cause」という独自の製品も公開しています。これは、本パックでは再実装していない手法を用いて、遅延した各便の遅延時間を原因別の小数カウントとして配分するものです。ここでの delay_cause テーブルは、route_month と同じフライト単位の遅延時間フィールド（航空会社／天候／NAS／保安／前便の遅延）から導出され、航空会社 × 到着空港 × 月単位で集計されます。値は小数カウントではなく、遅延時間の合計として報告されます。BTS が公開する独自の原因別内訳と整合しますが、行ごとに一致する保証はありません。これは単一の生データソースに対する1つの処理パイプラインであり、BTS 独自の集計データを2つ目にダウンロードしたものではありません。

既知の不足点 — このパックを拡張する前にお読みください

カバレッジは、読み込み時点での直近数か月分であり、全期間ではありません。 BTS の一括ファイルサーバーは、接続ごとに厳しく速度を制限します。ファイルを 1 つダウンロードするのに約 170 秒かかることが測定されました。並列数を少し増やしても改善は限定的で、この上流から 3 件を並列ダウンロードした場合も、1 件ずつ順番にダウンロードした場合とほぼ同じ経過時間でした（2026-10-12 に測定）。そのため、1987 年から現在までの全アーカイブ（400 件以上の月次ファイル）を一度に取得するには数時間かかり、パックのビルド工程として行うものではありません。今回の初回読み込みでは、両方のテーブルについて、2026-10-12 時点の直近 12 か月分を対象としています（正確な範囲は list_coverage を呼び出して確認してください）。このコミットでは delay_cause 用に 2003 年以降のデータを別途バックフィルしているわけではありません。delay_cause は route_month と同じ月のデータから導出されています。

カバレッジの拡張は調査ではなく、定型作業です — 下記の「データの更新または拡張」を参照してください。より大きな --months を指定してローダーを再実行し、上流に配慮して --concurrency を調整すれば、さらに過去のデータを取得できます。スキーマやツールに変更はありません。

データの更新または拡張

node scripts/bts-ontime/load-data.mjs --months 12                 # default: most recent 12 months
node scripts/bts-ontime/load-data.mjs --months 36 --concurrency 4 # extend further back
node scripts/bts-ontime/load-data.mjs --through 2026-7            # pin the "latest" month instead of probing

Pipeworx の Cloudflare アカウントに wrangler でログインしている必要があります。各実行では追記ではなく、route_month、delay_cause、bts_ontime_meta を置き換えます（DROP ＋ 再読み込み）。BTS 自身の月次ファイルはときどき改訂されるため、取り下げられたファイルや修正済みファイルの古い行を残さないようにするには、データを消去して再読み込みするのが確実な方法です。月次更新（BTS は約 2 か月遅れで公開します）では、12 だけでなく、前回の読み込み以降の期間をカバーできる大きさの --months を指定して再実行してください。そうしないと、以前に読み込まれていた最も古い月が、気付かないうちに対象期間から外れてしまいます。

クイックスタート

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

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

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

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

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックで扱っていない質問にも対応できます。ask_pipeworx がカタログ全体から適切なツールにルーティングするため、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/route_ontime \
  -H 'Content-Type: application/json' \
  -d '{"origin":"JFK","dest":"LAX","months":3}'

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

単独での実行（ゲートウェイアカウント不要）

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

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

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-bts-ontime

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Bts Ontime data" })

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

More

• Docs and guides
• pipeworx.io

License

MIT