faregrid

faregrid

faregrid は、Google Flights からリアルタイムの航空券価格を取得する、ホストされた FlightPowers MCP サーバーへの小さなローカルブリッジです。出発地と目的地に加えて、単一の日付または日付範囲を指定すると、運賃、航空会社、所要時間、乗り継ぎ回数、各フライトの予約可能なリンク、その路線の運賃が通常より大幅に安いか高いかを示す過去の価格帯を返します。

このブリッジは独自の運賃データを保持しません。稼働中のエンドポイントから取得したとおりの上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得した機能は検索のみです。結果には販売元の予約フローへの buy_link が含まれますが、予約、購入、支払いを行うツールはありません。

ツール

• search_oneway_flights — 片道運賃です。必須項目： from_airport と to_airport（IATA コード。目的地には "BCN,LIS,ATH" のような複数のコード、または ["BCN","LIS","ATH"] を指定できます）。任意項目：departure_date、または departure_date_from／departure_date_to による範囲指定、max_stops、airline_codes、exclude_airline_codes、出発時刻と到着時刻の時間帯、currency（デフォルトは "usd"）、max_price、seat_type、passengers、sort_by（デフォルトは "best"）、limit（デフォルトは 10）、max_searches、use_fallback、verbose。1 回の呼び出しで、範囲内のすべての日付と目的地の組み合わせを検索できます。
• search_roundtrip_flights — 往復運賃です。片道を 2 回別々に検索するのではなく、往路と復路を組み合わせた運賃として価格が設定されます。 必須項目：from_airport と to_airport。任意項目：片道ツールと同じ出発日の単一日付または範囲指定フィールド、さらに return_date または nights（旅行日数、または [5, 6, 7] のようなリスト）、max_departure_stops、max_return_stops、departure_airline_codes、return_airline_codes、returns_per_outbound、および共通フィールドの currency、max_price、seat_type、passengers、sort_by、limit、max_searches、use_fallback、verbose です。

運賃は数分以内に古くなるため、最新の価格を得るには以前の結果ではなく、新たに検索する必要があります。

設定

• FLIGHTPOWERS_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://flights.flightpowers.com/mcp です。（この上書き用フックは、この再構築独自の、再構築であることを明記した機能です。）
• FLIGHTPOWERS_API_KEY（任意）— 設定すると、すべての上流リクエストに x-rapidapi-key: <key> ヘッダーが付加されます。これは Google Flights Live API 用の、呼び出し元自身の RapidAPI キーです。設定しない場合はキーのヘッダーを送信せず、上流の無料サインイン枠が適用されます。Authorization ヘッダーは一切送信されません。（この転送も、再構築独自の、再構築であることを明記した機能です。元の機能はキーなしで取得されました。）

転送の仕組み

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

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

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/faregrid search_oneway_flights '{"from_airport":"TLV","to_airport":"BCN","departure_date":"2026-11-10"}'
npx @reneturcios/faregrid search_roundtrip_flights '{"from_airport":"TLV","to_airport":"BCN,LIS","departure_date_from":"2026-11-01","departure_date_to":"2026-11-07","nights":[3,4]}'
npx @reneturcios/faregrid --version

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

MCP サーバー

npx -y @reneturcios/faregrid mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

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