# opspawn
## 基本信息
- Slug: `opspawn-google-flights-mcp-server`
- Source: modelscope
- Publisher: @opspawn/Google-Flights-MCP-Server
- Categories: travel-and-transportation / browser-automation / web-scraping
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@opspawn/Google-Flights-MCP-Server
## 简介
暂无描述。
## MCP Server 详情

# 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`)。

## 设置

1.  **克隆仓库：**
    bash
    git clone https://github.com/opspawn/Google-Flights-MCP-Server.git
    cd Google-Flights-MCP-Server
    
2.  **创建虚拟环境（推荐）：**
    bash
    python -m venv .venv
    source .venv/bin/activate  # 在Windows上使用 `.venvScriptsactivate`
    
3.  **安装依赖项：**
    bash
    pip install -r requirements.txt
    
4.  **安装Playwright浏览器（`fast_flights`需要）：**
    bash
    playwright install
    

## 运行服务器

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

bash
python server.py


服务器默认使用STDIO传输。

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

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

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](https://github.com/AWeirdDev/flights)），用于其核心航班抓取功能。请参阅随附的`LICENSE`文件了解其条款。
*   航班抓取有时可能会因Google Flights的变化和网络条件而变得不可靠或缓慢。这些工具包括基本的错误处理。
*   `find_all_flights_in_range`工具可能非常耗费资源，因为它会检查许多日期组合。