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（可选）— 设置后，每个 上游请求都会携带 x-api-key: <key> 标头，使用调用者自己的 HasData API 密钥。未 设置时，不会发送密钥标头。（标头名称和环境 变量名称由原始项目的注册记录确定；从此环境 变量转发密钥是本次重建自行标注的内容——原始 接口是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求 （protocolVersion 2025-03-26，clientInfo 名称 为 flightdata），再发送 notifications/initialized 通知，随后发送携带 调用者参数（保持不变）的 tools/call 请求。上游 通过 initialize 响应并带有 Mcp-Session-Id 标头时， 该值会随会话中的所有后续请求一同发送；此会话在 进程存续期间重复使用。响应可能是普通 JSON，也 可能是服务器发送的事件；两种格式都会读取。

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

命令行

该工具也是一个子命令，接受一个 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 服务；其他参数则会正常传递给命令行。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全使用桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。