Google Flights MCP 服务器

一个模型上下文协议 (MCP) 服务器实现，可将您的 Agent 或 LLM 连接到 Google Flights 数据。访问航班信息，查找最便宜的选项，按时间限制进行筛选，并获取 Google Flights 的最佳推荐！

🌍 概述

此 MCP 服务器提供对 Google Flights 数据的无缝访问，使您的 AI 代理能够：

• 检索全面的航班信息
• 查找最便宜的可用航班
• 根据特定时间限制筛选航班
• 获取 Google Flights 推荐的最佳航班

<br>

**注意：**目前，此工具仅支持单程（如果您要求往返，它会执行两个单程！），因为我将其构建为一个有趣的个人项目，以了解 MCP。

如果有人觉得这真的有用，或者希望我这样做，我可以努力添加往返和多城市功能！！只需提出 PR 或 联系我！

🎥 使用方法 & 演示

只需按照快速入门进行设置，即可用于 Claude Desktop、Cursor 或其他 MCP 客户端，然后就可以随意询问您想要的航班信息！！

[插入 Claude Desktop 演示视频]

🛠️ 工具

可用函数/工具

1. get_general_flights_info()：检索给定路线的全面航班信息

   • 提供多达 40 个航班的详细航班信息
   • 返回人类可读的航班描述列表

2. get_cheapest_flights()：查找最实惠的航班选项

   • 按最低价格对航班进行排序和返回
   • 包括当前整体路线定价信息

3. get_best_flights()：获取 Google Flights 推荐的顶级航班

   • 识别并返回 Google Flights 标记为“最佳”的航班
   • 帮助用户找到最佳航班选择

4. get_time_filtered_flights()：按特定时间限制筛选航班

   • 搜索目标时间之前或之后的航班
   • 允许精确的日程安排偏好

输入参数

必需参数

• origin: str - 出发机场 IATA 代码（例如，“ATL”、“SCL”、“JFK”）

• destination: str - 目的地机场 IATA 代码（例如，“DTW”、“ICN”、“LIR”）

• departure_date: str - 出发日期，格式为 YYYY-MM-DD

可选参数

• trip_type: str - 行程类型，可以是“one-way”或“round-trip”（默认值：“one-way”）

• seat: str - 座位类型：“economy”、“premium-economy”、“business”或“first”（默认值：“economy”）

• adults: int - 成人乘客人数（默认值：1）

• children: int - 儿童乘客人数（默认值：0）

• infants_in_seat: int - 需要座位的婴儿人数（默认值：0）

• infants_on_lap: int - 坐在膝盖上的婴儿人数（默认值：0）

特定函数的附加参数

• n_flights: int - 要返回的航班数量（默认值：40，仅适用于 get_general_flights_info()）

• state: str - 时间筛选状态，可以是“before”或“after”（仅适用于 get_time_filtered_flights()）

• target_time_str: str - 目标时间，格式为 HH:MM AM/PM（仅适用于 get_time_filtered_flights()）

⚡ 快速入门

Claude Desktop

1. 确保您已下载最新的 Claude for Desktop！

2. 克隆此存储库

3. 安装 uv 以设置我们的 Python 环境

   MacOS

   # 检查是否已安装 uv
   uv --version
   
   # 如果未安装
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   Windows

   # 检查是否已安装 uv
   uv --version
   
   # 如果未安装
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

   ⚠️ 重要提示：安装后，您必须重新启动终端才能获取 uv 命令！

4. 将此 flights MCP 服务器添加到您的 Claude for Desktop 配置：

   MacOS

   • 通过终端导航到配置文件位置：~/Library/Application Support/Claude/claude_desktop_config.json
   • 或者，如果您有 VSCode 和 Code 别名，则可以使用以下命令创建/编辑：

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   Windows

   • 通过 PowerShell 导航到配置文件位置：%AppData%\Claude\claude_desktop_config.json
   • 或者，如果您有 VSCode 和 Code 别名，则可以使用以下命令创建/编辑：

   code $env:AppData\Claude\claude_desktop_config.json
   

   注意：~/Library/Application Support/Claude/config.json 是一个不同的、不相关的文件。请勿编辑它。

5. 在 mcpServers 键中添加此 flights MCP 服务器：

   {
     "mcpServers": {
       "flights": {
         "command": "/ABSOLUTE/PATH/.local/bin/uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

   确保修改代码以包含 command 参数的 uv 的绝对路径，以及 args 参数的此存储库的绝对路径。

   您可能需要在 command 字段中放置 uv 可执行文件的完整路径。您可以通过运行以下命令获取此路径：

   • MacOS/Linux 上为 which uv
   • Windows 上为 where uv

   示例：

   {
     "mcpServers": {
       "flights": {
         "command": "/Users/sahitmamidipaka/.local/bin/uv",
         "args": [
           "--directory",
           "/Users/sahitmamidipaka/Documents/Google-Flights-MCP-Server",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

6. 就是这样！打开 Claude for Desktop，您应该会看到出现小的 MCP 工具图标（确保重新打开应用程序以使更新生效——每当您更改 claude_desktop_config.json 文件时，都需要这样做 😊）

<!-- Claude Desktop MCP Tools Icon --> <img src="./assets/images/claude-mcp-tool.png" alt="Claude Desktop MCP Tools Icon" />

有关更多信息，请参阅 官方 MCP 文档。 <br>

Cursor

1. 打开 Cursor 并转到设置

2. 按左侧面板上的 MCP 选项卡

3. 添加新的 MCP 服务器（选择一个）：

   项目配置

   • 在您的项目目录中创建一个 .cursor/mcp.json 文件
   • 非常适合特定于单个项目的工具

   全局配置

   • 在您的主目录中创建一个 ~/.cursor/mcp.json 文件
   • 使 MCP 服务器在所有 Cursor 工作区中可用

4. 将以下配置附加到 mcp.json 文件中：

   {
     "mcpServers": {
       "flights": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

   确保将 /ABSOLUTE/PATH/TO/PARENT/FOLDER 替换为此存储库的实际路径。

   您可能需要在 command 字段中放置 uv 可执行文件的完整路径。您可以通过运行以下命令获取此路径：

   • MacOS/Linux 上为 which uv
   • Windows 上为 where uv

   示例：

   {
     "mcpServers": {
       "flights": {
         "command": "/Users/sahitmamidipaka/.local/bin/uv",
         "args": [
           "--directory",
           "/Users/sahitmamidipaka/Documents/Google-Flights-MCP-Server",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

<!-- Cursor MCP Image --> <img src="./assets/images/cursor-mcp.png" alt="Cursor Flights MCP Image" />

有关更多信息，请参阅 官方 Cursor MCP 文档。

🚀 使用示例

• 显示 2026 年 1 月 1 日从亚特兰大到上海的航班选项
• 本周末从底特律到亚特兰大的航班价格如何？
• 我住在纽约，想去日本。查找本周五出发的最便宜的航班选项，并考虑我附近的所有机场！
• 显示今天从 LAX 出发的航班选项，但仅在晚上 8:00 之后

✨ 即将推出的功能

• 更好的往返功能 🚀
• 多城市功能 🌍
• 探索/去任何地方功能 🗺️
• 价格图表和价格历史记录 📈

🤝 贡献

请随意：

• 针对错误或功能请求打开 issue
• 提交 pull request
• 直接通过 sahit.mamidipaka@gmail.com 与我联系

📄 许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

这意味着您可以自由地：

• 将该软件用于商业用途
• 修改源代码
• 分发该软件
• 私下使用该软件

您必须在任何分发的软件或衍生作品中包含原始版权声明和引文，如 MIT 许可证的条款所述。

---

感谢您查看本项目！随时可以出于任何原因与我联系。

**注意：**本项目是为了娱乐而创建的，绝不由 Google、Google Flights 或任何其他 Alphabet 子公司公司认可或附属。