关键词

航班搜索旅行规划智能助手谷歌航班API服务

项目简介

Google Flights MCP服务器是一个功能强大的Model Context Protocol (MCP) 后端应用，旨在将Google航班数据无缝集成到您的人工智能工作流中。它允许您通过自然语言查询进行航班搜索、智能价格比较以及自动化旅行规划，并通过Claude等MCP兼容客户端进行交互。该服务器内置了10个专业工具、2个资源端点和10个智能Prompt模板，提供全面的旅行规划能力。

主要功能点

  • 智能航班搜索: 支持单程、往返、日期范围和多城市航班查询。
  • 灵活的筛选: 可按直飞、航空公司、最大经停次数、乘客数量和舱位等级进行筛选。
  • 旅行日期计算: 智能计算相对日期，简化旅行规划。
  • Google航班URL生成: 直接创建可分享的Google航班搜索链接。
  • 机场信息查询: 提供全球机场代码和名称的资源访问。
  • 上下文感知Prompt: 提供多种预设Prompt，如“寻找最优惠价格”、“周末度假”、“商务出行”等，优化LLM交互。
  • 可选SerpApi回退: 当网页抓取失败时，可配置SerpApi作为可靠的航班数据来源。
  • 性能优化: 支持紧凑模式输出（节省Token）和结果分页。

安装步骤

  1. 确保Python环境: 您的系统需要安装Python 3.10或更高版本。

  2. 安装MCP服务器: 推荐使用 'uvx' 或 'pipx' 进行隔离安装，这可以避免依赖冲突。您也可以使用 'pip' 进行全局安装。

    • 使用 'uvx' (推荐，无需预先安装，在隔离环境中运行): 
      uvx mcp-server-google-flights
    • 使用 'pipx' (推荐，用于全局隔离安装): 
      pipx install mcp-server-google-flights
    • 使用 'pip' (全局安装): 
      pip install mcp-server-google-flights

  3. 安装Playwright浏览器: 服务器内部依赖Playwright进行网页抓取，因此需要安装其所需的浏览器驱动。请在安装服务器后运行此命令：

    playwright install

服务器配置

MCP服务器需要通过MCP客户端（如Claude Desktop或VS Code Cline插件）连接。以下是为这些客户端配置此服务器的JSON示例。请将以下JSON片段添加到您的MCP客户端配置文件中（例如，macOS上的'~/Library/Application Support/Claude/claude_desktop_config.json' 或 VSCode Cline插件的'.cline/cline_mcp_settings.json'）。

如果您通过 'uvx' 或 'pipx' 安装：

{
  "mcpServers": {
    "google-flights": {
      "command": "uvx",
      "args": ["mcp-server-google-flights"],
      "env": {
        // 可选配置：如果您希望在主要航班数据抓取失败时，MCP服务器能自动回退到SerpApi（以提高稳定性），
        // 请在此处设置您的SerpApi API Key。
        // 获取API Key请访问：https://serpapi.com
        // "SERPAPI_API_KEY": "您的SerpApi_API_Key_在此填写"
      },
      // 如果您是为Cline（VS Code插件）配置，还需要添加以下两个字段：
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置说明:

  • '"google-flights"'：这是此MCP服务器在您的MCP客户端中显示的唯一标识符和名称。
  • '"command"'：指定启动MCP服务器的可执行命令。'uvx' 是一个便利的工具，可以在隔离环境中运行软件包。
  • '"args"'：传递给 'command' 的参数列表。'mcp-server-google-flights' 是此服务器的启动脚本名称。
  • '"env"'：一个可选的JSON对象，用于设置服务器运行时的环境变量。特别是，如果您配置了 'SERPAPI_API_KEY'，服务器将在Google Flights网页抓取失败时，自动尝试使用SerpApi获取航班数据，这能显著提高搜索的成功率。

基本使用方法

配置完成后，重新启动您的MCP客户端（例如，关闭并重新打开Claude Desktop，或在VS Code中重新加载Cline插件）。AI助手将能够识别并调用“Google航班MCP服务器”提供的工具和资源。您可以通过自然语言向AI助手提问，例如：

  • 简单往返查询: “帮我查找从纽约到伦敦，7月15日出发，7月25日返回的往返航班，经济舱，2位成人。” (AI将调用 'search_round_trip_flights' 工具)

  • 灵活日期搜索: “我想在2026年3月的某个周末去东京旅行一周左右，哪个周末最便宜？” (AI将调用 'search_round_trips_in_date_range' 工具，并可能结合 'weekend_getaway' Prompt)

  • 直飞航班查询: “只找从芝加哥到西雅图的直飞航班，日期是2026年3月15日。” (AI将调用 'search_direct_flights' 工具)

  • 机场信息查询: “我想了解机场代码JFK的详细信息。” (AI将访问 'airports://JFK' 资源)

服务器会自动处理这些请求，调用相应的航班查询工具，并将结构化的结果返回给AI客户端，由AI进行总结和呈现。

信息

分类

网页与API

访问项目