dealdata

dealdata

dealdata 是一个小型本地桥接工具，连接托管的 HasData Google Flights deals MCP 服务。提供一个自然语言的 旅行构想——海滩度假、日本樱花之旅、香港烟花节——再加上一个 出发机场，Google 就会选择目的地和旅行日期， 并返回优惠信息，包括去程和返程日期、价格、 飞行时长、行程长度、经停次数、承运航空公司、 出发和到达机场，以及 Google Flights 链接。如果搜索条件由 Google 自行确定， 优惠信息还可能包含典型价格及其折扣、带照片的目的地 介绍，以及 Google 根据查询推导出的日期范围。

此桥接工具不存储任何自己的票价数据。它会在本地提供 上游服务的工具列表，内容与从在线端点捕获的内容完全一致， 并将每次工具调用转发至上游，原样返回结果。捕获到的 工具范围仅包含一个只读优惠搜索：只有已发布的票价数据， 不包含预订、订位、出票或支付工具。

工具

• hasdata_google_travel_flights_deals_getGoogleFlightsDeals — 将旅行描述转换为 Google Flights 优惠信息。 必填：q（自然语言旅行描述） 和 departureId（一个出发机场，使用 3 个字母的 大写 IATA 代码）。可选：arrivalId（通过 IATA 代码或地点 kgmid 指定一个目的地；所有票价筛选条件都要求提供此项）、type（往返或单程）、 travelClass（经济舱、高级经济舱、商务舱、头等舱）、outboundDate 和 returnDate（具体日期或日期范围）、travelDuration（一周、 周末、两周）、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（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，使用调用者自己的 HasData API 密钥。未设置时， 不会发送密钥标头。（标头名称和环境变量名称由原始项目的 注册记录确定；从此环境变量转发密钥属于特别标注的还原实现——原始 工具范围是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo name dealdata），接着发送 notifications/initialized 通知，然后发送携带调用者参数 且不作更改的 tools/call 请求。上游在响应 initialize 时若带有 Mcp-Session-Id 标头，该值会随会话中的 每个后续请求一同发送；该会话会在进程运行期间重复使用。响应 可能是普通 JSON，也可能是服务器发送事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标记。失败——JSON-RPC 错误、非 2xx 状态码、 无法读取响应或无法完成请求——会以 isError 结果返回， 其文本以 dealdata error: 开头（此错误呈现方式是本次重建 中特别标注的还原实现）。

CLI

此工具也可作为子命令使用，并接受一个 JSON 参数字符串：

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。