flightdata

flightdata

flightdata は、ホスト型の HasData Google Flights MCP サーバーへの小規模なローカルブリッジです。このサーバーは Google Flights の検索結果を JSON として返します。出発地、目的地、往路の日付を指定すると、条件に合う旅程を取得します。各オプションの料金、合計所要時間と乗り継ぎ回数、航空会社、便名、機材、空港、時刻を含む各フライト区間、CO2 排出量のほか、選択した旅程について後から問い合わせるために上流サーバーが発行する予約トークンと出発トークンも取得します。

検索対象は片道、往復、複数都市の旅行です。乗客の構成（大人、子ども、座席を使用する幼児、膝上の幼児）、旅行クラス、機内持ち込み手荷物、上限料金、並べ替え順（料金、所要時間、排出量、出発時刻、到着時刻）、乗り継ぎ回数の上限、航空会社や乗り継ぎ地点の指定・除外、出発と帰路の時間帯、乗り継ぎ時間の範囲、合計所要時間の上限、排出量の優先設定、詳細検索モードで条件を指定できます。

このブリッジは独自の運賃データを保存しません。上流サーバーのツール一覧を、稼働中のエンドポイントから取得した内容そのままローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得した機能は読み取り専用の運賃検索のみです。予約、座席確保、発券、支払いのツールはありません。

ツール

• hasdata_google_travel_flights_getGoogleFlights — Google Flights を検索します。必須項目：departureId （IATA コードまたは場所の kgmid。カンマ区切りで 複数指定できます）、arrivalId（同じ形式）、 outboundDate（yyyy-MM-dd）。任意項目： returnDate、type（roundTrip / oneWay / multiCity）、multiCityJson、gl、hl、 currency、travelClass（economy / premiumEconomy / business / first）、 showHidden、adults、children、 infantsInSeat、infantsOnLap、sortBy （topFlights / price / departureTime / arrivalTime / duration / emissions）、 stops（nonStop / oneStopOrFewer / twoStopsOrFewer）、excludeAirlines、 includeAirlines、bags、maxPrice、 outboundTimes、returnTimes、lessEmissions、 layoverDuration、includeConnections、 excludeConnections、maxDuration、deepSearch、 departureToken、bookingToken。旅程ごとの料金、 所要時間、乗り継ぎ回数とフライト区間、 排出量、予約トークンと出発トークンを返します。

設定

• HASDATA_GOOGLE_FLIGHTS_MCP_URL（任意）— 上流エンドポイントを上書きします。既定値は https://mcp.hasdata.com/mcp?apis=google_travel_flights です。 （この上書き用フックは、この再構築で独自に追加したものとして明示しています。）
• HASDATA_API_KEY（任意）— 設定すると、すべての 上流リクエストに呼び出し元自身の HasData API キーを指定する x-api-key: <key> ヘッダーを付加します。未設定の場合、 キーのヘッダーは送信されません。（ヘッダー名と環境変数名は元の レジストリレコードで特定されています。この環境変数からキーを 転送する動作は、再構築で独自に追加したものとして明示しています。 元の機能はキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name flightdata）を送り、次に notifications/initialized 通知を送り、その後、呼び出し元の引数を 変更せずに格納した tools/call リクエストを送ります。上流が initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、 その値はセッションの後続のすべてのリクエストに付加され、 プロセスの終了まで同じセッションが再利用されます。応答は 通常の JSON またはサーバー送信イベントで届く場合があり、どちらも読み取ります。

上流からの正常な結果は、上流が設定した isError フラグも含め、 そのまま返されます。失敗（JSON-RPC エラー、2xx 以外のステータス、 読み取り不能な応答、または完了できないリクエスト）は、 テキストが flightdata error: で始まる isError 結果として返されます （このエラーの表示方法は、この再構築で独自に追加したものとして明示しています）。

CLI

このツールは、1つの JSON 引数文字列を受け取るサブコマンドでもあります。

npx @reneturcios/flightdata hasdata_google_travel_flights_getGoogleFlights '{"departureId":"SFO","arrivalId":"LHR","outboundDate":"2026-12-01","type":"oneWay","travelClass":"economy","stops":"nonStop"}'
npx @reneturcios/flightdata --version

終了コード：成功時は 0、結果が isError の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/flightdata mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/flightdata
docker run --rm ghcr.io/cloudcorprecords/flightdata --version

コンテナのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートは、スタブ化された JSON-RPC アップストリームのみを使用して実行され、実際のネットワーク呼び出しは行いません。

ライセンス

MIT — LICENSE を参照してください。