Google Flights MCP Server

一个托管的 Model Context Protocol (MCP) 服务器，为 Claude、Cursor、Windsurf 以及任何其他 MCP 客户端提供一个 Google Flights 工具。可以搜索单程、往返和多城市行程，返回票价、航段、碳排放和价格历史，全部以结构化 JSON 呈现；无需 Google 账号，也无须处理已停用的旅行 API。

https://mcp.hasdata.com/api/mcp?apis=google_travel_flights

目录

• 你需要什么

• 快速开始

• 示例提示

• 工具

• 错误与失败路径

• 定价、免费额度和限制

• 工具选择

• 它与其他方案的对比

• 常见问题

• HasData 链接

• 开发

• 贡献

• 许可证

Related MCP server: SkyOdyssey MCP

你需要什么

一个 MCP 客户端，以及从控制台获取的 HasData API 密钥；免费创建，无需银行卡，以 15 积分/次的费率计算，试用额度大约可覆盖 66 次调用。这是一个远程服务器，因此最简单的接入方式就是一个 URL 和 x-api-key 请求头，无需运行容器，整个流程中也不涉及 Google 账号。只支持 stdio 的客户端可以通过一个轻量启动器（launcher）访问它；该启动器以 @hasdata/google-flights-mcp 发布在 npm 上，以 hasdata-google-flights-mcp 发布在 PyPI 上，如下所示。

快速开始

服务器 URL 对所有客户端都一样。我们已在 Claude Code 和 Claude Desktop 中实际运行过。其他配置块遵循各客户端自己文档中规定的远程服务器格式。

支持 OAuth 的客户端可以将相同的 URL 作为连接器添加，然后直接登录，无需在配置文件中填入密钥。

claude mcp add --transport http google-flights "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights" \
  --header "x-api-key: HASDATA_API_KEY"

依次进入设置（Settings）、连接器（Connectors）、添加自定义连接器（Add custom connector），然后粘贴 https://mcp.hasdata.com/api/mcp?apis=google_travel_flights 并登录。

对于使用配置文件的路线，Claude Desktop 只加载本地（stdio）服务器，因此它通过一个 stdio 启动器访问远程服务器。@hasdata/google-flights-mcp 包就是这个启动器，它会从环境中读取密钥。将它添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "google-flights": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

若使用 Python 而非 Node，可将启动器换成 PyPI 包，uvx 无需手动安装即可运行它：

{
  "mcpServers": {
    "google-flights": {
      "command": "uvx",
      "args": ["hasdata-google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json 用于所有项目，或 .cursor/mcp.json 用于单个项目：

{
  "mcpServers": {
    "google-flights": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json。Windsurf 将该字段称为 serverUrl，而不是 url：

{
  "mcpServers": {
    "google-flights": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

工作区中的 .vscode/mcp.json：

{
  "servers": {
    "google-flights": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

示例提示

这些是提示词，不是代码。粘贴一条，智能体会自己选择工具。每条都标注了需要的调用次数，因为每次成功调用消耗 15 积分。

查找 9 月 15 日从 JFK 飞往伦敦希思罗的单程航班，按价格排序，并给我最便宜的三趟，包含航空公司和碳排放估算。

一次调用，15 积分。票价、航段和排放量会一起返回。

同一路线，但仅直飞、公务舱，并告诉我哪个选项的碳排放最低。

一次调用，15 积分。舱位和中转次数都是同一次请求中的筛选条件。

考虑到价格历史，现在 JFK 到 LHR 的 295 美元是不是好价格？

一次调用，15 积分。响应会携带 priceInsights，包含典型价格区间和价格水平。

JFK 到 LHR 往返，9 月 15 日去、9 月 22 日回，最便宜的票价。

两次调用，30 积分。Google 先返回去程选项，然后根据你选择的选项，第二次调用获取对应的返程航段。

往返行程按设计需要两次调用。第一次返回去程行程，每个行程带一个 departureToken；你把该令牌传回去，就能获得匹配的返程航班。单程和价格查询各只需一次调用。

工具

一个只读工具。下面的示例截取自一次真实调用并做了删减，而且票价时刻在变动。把它当作一种结构示例来看。工具名称链接到其端点参考文档，其中包含完整的参数列表。

该示例是载荷（payload），不是完整响应。tools/call 的结果包含一个文本块，而该文本本身是 JSON，包含 url、status、text 和 json，抓取的数据位于 json 之下。从原始 JSON-RPC 响应来看，路径是 result.content[0].text，解析后再取 .json。聊天客户端会为你解包；直接与端点通信的代码则不会。

获取 Google Flights 结果

hasdata_google_travel_flights_getGoogleFlights

返回某条航线在指定日期的行程，包含票价、航段、碳排放和价格历史。

参考文档还记录了 includeConnections、excludeConnections、layoverDuration、outboundTimes、returnTimes、showHidden、lessEmissions 和 multiCityJson。

结果分为 bestFlights 和 otherFlights。每个行程包含 price、type、以分钟为单位的 totalDuration、一个由航段组成的 flights 数组、一个 carbonEmissions 对象，以及一个 bookingToken。每个航段包含 departureAirport 和 arrivalAirport（各自带有 id、name 和当地 time），以及 duration、airline、flightNumber、airplane、legroom、travelClass、一个 extensions 数组，以及 Google 标记航段上的 oftenDelayedByOver30Min。直飞行程只有一个航段，中转行程则有多个航段。

carbonEmissions 的单位是克，不是千克。thisFlight: 433000 即 433 千克。differencePercent 将它与 typicalForThisRoute 比较，因此负数表示比平均航班更环保。

{
  "price": 295,
  "type": "One way",
  "totalDuration": 415,
  "flights": [
    {
      "departureAirport": { "id": "JFK", "name": "John F. Kennedy International Airport", "time": "2026-09-15 8:15" },
      "arrivalAirport": { "id": "LHR", "name": "Heathrow Airport", "time": "2026-09-15 20:10" },
      "duration": 415,
      "airline": "Virgin Atlantic",
      "flightNumber": "VS 26",
      "airplane": "Boeing 787",
      "travelClass": "Economy"
    }
  ],
  "carbonEmissions": { "thisFlight": 367000, "typicalForThisRoute": 419000, "differencePercent": -12 },
  "bookingToken": "W1t7..."
}

priceInsights 与行程列表并列，包含 lowestPrice、typicalPriceRange、类似 typical 的 priceLevel，以及由 [timestamp, price] 数据点组成的 priceHistory。airports 会回显解析后的出发机场和到达机场，并包含城市和国家。

错误与失败路径

你的客户端几乎不会在工具调用中看到 HTTP 错误码。MCP 层会返回 200，并把失败信息放在结果内部，isError 设为 true，原因以文本形式呈现。在你可能预期看到状态行的地方，智能体读到的是一条消息。

错误的密钥会以工具输出的形式出现，而不是连接失败。 tools/list 接受任何非空密钥并返回工具，因此客户端能完成握手并显示绿色。第一次工具调用随后返回 isError: true，文本为 HasData API error: 401。请留意这个字符串，因为流程中早先没有任何环节会报告该问题。

缺少密钥是唯一真正的 HTTP 错误。 授权在任何工具之前执行，连接本身会以 401 失败。CORS 头存在，浏览器客户端能读取状态，而不是得到一个不透明的网络错误。

破坏工具 schema 的参数会在变成抓取请求之前被拒绝。 服务器返回 isError: true，文本为 MCP error -32602: Input validation error，并指出出错的字段。没有 returnDate 的 roundTrip，或者 includeAirlines 与 excludeAirlines 同时出现，都会在这里被拦截。

某日期航线上没有航班时，会返回一个成功结果，但行程数组为空，而不是错误。requestMetadata.status 仍为 ok。在对航班排序之前，请先检查是否存在航班。

错误的机场代码会返回 400，其中 requestMetadata.status 设置为 error。请使用 IATA 代码或 kgmids，而不是城市名称。

携带数据的结果还会带有 requestMetadata.id，在联系支持时值得附上。

定价、免费套餐和限制

每次成功的 Google Flights 调用需要 15 个积分。响应大小不会改变价格，深度搜索与标准搜索费用相同。

免费试用为 30 天内 1,000 个积分，无需绑定银行卡，大约相当于 66 次航班搜索。之后，只要活跃账户的余额低于 100，系统每天都会为其补充 100 个积分，因此低流量智能体可以无限期运行在免费套餐上。

付费套餐起价为 每月 $49，提供 200,000 个积分，大约相当于 13,000 次搜索。单价随用量下降，从入门套餐的 每 1,000 次调用 $3.68，到 Business 的 $1.49、Growth 的 $1.25，以及最大 高用量套餐 的 $1.12。

你的套餐还设定了并发限制。免费试用允许同时 1 个请求，Startup 15 个，Business 30 个，Growth 50 个，高用量套餐为 200 到 1,500 个。在任何无人值守的程序中都要防御性地处理溢出情况。

返回非 200 的请求不会计费。往返行程是两次调用，所以要为此做好预算。

工具选择

apis 查询参数决定你的智能体可以看到哪些工具。工具越少，用于工具定义的上下文就越少，模型选错工具的机会也就越小。

?apis=google_travel_flights          the one tool in this repo
?apis=google_travel                   add Google Hotels
?apis=google_travel_flights,airbnb    flights plus Airbnb stays

该参数接受提供方名称，如 google_travel，以及单个 API 名称，如 google_travel_flights。拼写错误的名称会被忽略。如果所有名称都错误，请求会以 400 失败，响应体会列出它无法识别的名称以及所有有效值。省略该参数后，同一端点会暴露全部 57 个 HasData 工具。

对比

Google 于 2018 年退役了 QPX Express 航班 API，并且从未推出替代品，因此没有官方的 Google Flights API。剩下的路径是抓取公开结果，或获取原始 GDS 票价数据的授权，后者既笨重又昂贵。此服务器读取网站展示的相同结果，并以 JSON 形式返回。

此服务器不做什么。 不提供预订，也不处理付款。它读取票价、航段以及 Google 自身用于跳转到预订流程的 token，并把预订步骤交还给你。

常见问题

有官方的 Google Flights API 吗？

没有。Google 于 2018 年关闭了 QPX Express，并且没有推出替代品。所有方案读取的都是网站提供的同一份公开结果。本方案由 HasData 维护，并以结构化 JSON 返回这些结果。

什么是 Google Flights MCP 服务器？

这是一种将 Google Flights 作为可供 AI 客户端调用的工具来暴露的服务器。客户端通过 Model Context Protocol 发送工具调用，服务器获取行程并以结构化 JSON 返回，模型再处理该结果。本服务器暴露单个工具，并且远程运行。

为什么往返行程是两次调用？

Google 先返回去程选项，每个选项带有一个 departureToken。你选择一个，并把这个 token 传回，以获取与之配对的返程航班。这与网站的工作方式一致，也是往返行程需要 30 个积分的原因。

碳排数字的单位是千克吗？

不，是克。thisFlight: 433000 表示 433 kg，differencePercent 将其与航线平均值进行比较。

什么是深度搜索？

一种较慢的模式，返回的内容与 Google Flights 在浏览器中显示的内容完全一致。为了速度可以关闭它；当需要与网站保持一致时再开启。

我可以将它与其它 HasData API 一起使用吗？

可以。apis 参数接受一个列表，?apis=google_travel 会在航班之外加上 Google Hotels。省略该参数，你会获得所有工具。

合规性与个人数据

HasData 仅访问公开可用的数据。平台的服务条款可能限制自动访问，你需要自行负责合规。

HasData 链接

开发

该仓库是远程服务器的配置和文档。没有构建步骤，也无需容器化。

test/ 中的测试断言工具契约，即即使本仓库没有提交也可能出问题的部分。它们检查 ?apis=google_travel_flights 是否恰好返回一个工具、是否仍声明其必填参数、名称是否未变，以及正在使用的密钥是否确实被接受。最后一项检查会真实调用该工具并花费 15 个积分，这正是金丝雀测试能够因正确原因而失败的代价。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同一套测试会在每次推送时于 CI 中运行，并按计划每周运行一次，因为即使没有人改动本仓库，上游工具列表也可能发生变化。失败意味着工具列表变了、密钥失效了，或者端点无法访问，断言消息会说明具体是哪一种。

贡献

对参数表和响应示例的修正是最有用的贡献，因为这些部分最容易漂移。请附上你发出的调用和收到的响应。来自 fork 的 Pull Request 会在没有密钥的情况下运行测试套件，在线检查会跳过而不会报红。

许可证

MIT。参见 LICENSE。