MCP 服务器

Google-Flights-MCP-Server

这个 MCP 服务器允许 AI 助手使用 Google Flights 在线搜索航班信息。它可以查找特定日期的航班，也可以搜索一系列日期以查找所有选项或仅查找最便宜的选项。

README

Google Flights MCP 服务器

此 MCP 服务器提供使用捆绑的 fast_flights 库与 Google Flights 数据交互的工具。

功能

提供以下 MCP 工具：

get_flights_on_date: 获取两个机场之间特定日期的可用单程航班。
- 参数：origin (str，出发地), destination (str，目的地), date (str，日期，YYYY-MM-DD), adults (int，可选，成人数量), seat_type (str，可选，舱位类型), return_cheapest_only (bool，可选，默认为 False，仅返回最便宜的航班)。
get_round_trip_flights: 获取特定出发日期和返回日期的可用往返航班。
- 参数：origin (str，出发地), destination (str，目的地), departure_date (str，出发日期，YYYY-MM-DD), return_date (str，返回日期，YYYY-MM-DD), adults (int，可选，成人数量), seat_type (str，可选，舱位类型), return_cheapest_only (bool，可选，默认为 False，仅返回最便宜的航班)。
find_all_flights_in_range: 查找指定日期范围内的可用往返航班。可以选择仅返回每个日期组合中最便宜的航班。
- 参数：origin (str，出发地), destination (str，目的地), start_date_str (str，开始日期，YYYY-MM-DD), end_date_str (str，结束日期，YYYY-MM-DD), min_stay_days (int，可选，最短停留天数), max_stay_days (int，可选，最长停留天数), adults (int，可选，成人数量), seat_type (str，可选，舱位类型), return_cheapest_only (bool，可选，默认为 False，仅返回最便宜的航班)。

设置

克隆存储库：

git clone https://github.com/opspawn/Google-Flights-MCP-Server.git
cd Google-Flights-MCP-Server

创建虚拟环境（推荐）：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用 `.venv\Scripts\activate`

安装依赖项：
```
pip install -r requirements.txt
```
安装 Playwright 浏览器（fast_flights 需要）：
```
playwright install
```

运行服务器

您可以使用 Python 直接运行服务器：

python server.py

服务器默认使用 STDIO 传输。

与 MCP 客户端集成（例如，Cline、Claude Desktop）

将服务器添加到您的 MCP 客户端的配置文件中。例如，对于 cline_mcp_settings.json 或 claude_desktop_config.json：

{
  "mcpServers": {
    "google-flights": {
      "command": "/path/to/your/.venv/bin/python", // 使用虚拟环境 Python 的绝对路径
      "args": [
        "/absolute/path/to/flight_mcp_server/server.py" // 使用服务器脚本的绝对路径
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
    // ... 其他服务器
  }
}

重要提示： 将 command 和 args 中的路径替换为您系统上虚拟环境的 Python 可执行文件和 server.py 脚本的绝对路径。

注意事项

此服务器捆绑了 fast_flights 库（最初来自 https://github.com/AWeirdDev/flights），用于其核心航班抓取功能。请参阅随附的 LICENSE 文件以了解其条款。
航班抓取有时可能不可靠或缓慢，具体取决于 Google Flights 的更改和网络状况。这些工具包括基本的错误处理。
find_all_flights_in_range 工具可能会消耗大量资源，因为它会检查许多日期组合。