dealdata

dealdata

dealdata は、ホスト型 HasData Google Flights deals MCP サーバーへの小規模なローカルブリッジです。ビーチでの休暇、日本の桜、香港の花火大会など、平易な言葉で旅行のアイデアと出発空港を1つ指定すると、Google が目的地と旅行日を選び、往路と復路の日付、価格、飛行時間、旅行期間、乗り継ぎ回数、運航航空会社、出発空港と到着空港、Google Flights への直接リンクを含むお得なフライト情報を返します。Google が検索内容自体を作成した場合、通常価格と割引額、写真付きの目的地の説明、さらに Google がクエリから導き出した日付範囲もお得な情報に含まれることがあります。

このブリッジは独自の運賃データを保存しません。ライブエンドポイントから取得した上流サーバーのツール一覧を、そのままローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得された機能は、読み取り専用のお得なフライト検索のみです。公開済みの運賃データのみを扱い、予約、席の確保、発券、決済のツールは含まれません。

ツール

• hasdata_google_travel_flights_deals_getGoogleFlightsDeals — 旅行の説明から Google Flights のお得なフライト情報を取得します。 必須項目：q（平易な言葉での旅行の説明） および departureId（3文字の大文字 IATA コードで指定する出発空港1か所）。任意項目：arrivalId（IATA コードまたはロケーション kgmid で目的地を1か所に固定。すべての運賃フィルターで必須）、type（往復または片道）、travelClass（エコノミー、プレミアムエコノミー、ビジネス、ファースト）、outboundDate と returnDate （正確な日付または期間）、travelDuration（1週間、週末、2週間）、tripLength（日数。正確な日数または範囲）、stops、maxDuration（片道あたりの分数）、maxPrice、includeAirlines / excludeAirlines、 adults、children、infantsInSeat、infantsOnLap （同行者の合計は9人を超えられません）、およびローカライズ用の gl、hl、currency。

設定

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

転送の仕組み

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

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

CLI

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

npx @reneturcios/dealdata hasdata_google_travel_flights_deals_getGoogleFlightsDeals '{"q":"beach escape","departureId":"LAX"}'
npx @reneturcios/dealdata --version

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

MCP サーバー

npx -y @reneturcios/dealdata mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

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

ライセンス

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