使用说明

项目简介

本项目是基于 Model Context Protocol (MCP) 构建的航班搜索服务。它允许兼容MCP协议的LLM客户端通过调用预定义的 工具 (Tools) 来查询航班信息。此服务集成了 SerpAPI Google Flights API，能够根据用户提供的出发地、目的地和日期等信息，搜索并返回航班信息。

主要功能点

提供 MCP 协议兼容的航班搜索工具:
- 包含 'search_flights_tool' 工具，允许LLM客户端通过指定出发地、目的地和日期来搜索航班。
- 支持单程和往返机票查询。
提供服务器状态检查工具:
- 包含 'server_status' 工具，用于检查服务器是否正常运行。
支持 HTTP 和 Stdio 连接:
- 可以通过 HTTP 或 Stdio 方式与 MCP 客户端建立连接。

安装步骤

确保已安装 Python 环境。

使用 pip 安装 'mcp-flight-search' 包：

pip install mcp-flight-search

服务器配置

为了使 MCP 客户端能够连接到此航班搜索 MCP 服务器，需要进行如下配置。以下是 MCP 客户端所需的服务器连接配置信息（JSON 格式）：

{
  "server_name": "FlightSearchService",
  "command": "mcp-flight-search",
  "args": ["--connection_type", "http"]
  // 参数说明：
  // "server_name":  服务器名称，可自定义，用于在客户端标识服务器。
  // "command":  启动 MCP 服务器的命令，这里使用安装后可执行的 'mcp-flight-search' 命令。
  // "args":  传递给启动命令的参数列表。
  //   "--connection_type":  指定连接类型为 HTTP。可选值为 "http" 或 "stdio"。
  //
  // 可选参数 (添加到 "args" 数组中):
  // "--port": <端口号>  指定服务器监听的端口号，默认为 3001。例如 ["--connection_type", "http", "--port", "5000"] 将服务器端口设置为 5000。
}

注意:

启动服务器前，请务必配置 SerpAPI 密钥 环境变量 'SERP_API_KEY'。您需要在 SerpAPI 官网 (https://serpapi.com/) 注册并获取API密钥。

基本使用方法

配置 SerpAPI 密钥:

设置环境变量 'SERP_API_KEY' 为您的 SerpAPI 密钥。例如，在终端中执行：

export SERP_API_KEY="your-api-key-here"

启动 MCP 服务器:

在终端中运行以下命令启动航班搜索 MCP 服务器 (HTTP 连接方式)：

mcp-flight-search --connection_type http

您也可以使用 Python 直接运行 'main.py' 文件：

python main.py --connection_type http

如果需要指定端口，例如使用端口 5000，可以添加 '--port' 参数：

python main.py --connection_type http --port 5000

在 MCP 客户端中使用:
- 将上述 服务器配置 信息添加到您的 MCP 客户端配置中。
- 客户端连接到服务器后，即可调用 'search_flights_tool' 工具，并根据工具的参数提示 (origin, destination, outbound_date, return_date) 进行航班搜索。

关键词