MCP Flight Search

MCP Flight Search是一个基于Model Context Protocol (MCP)的航班搜索服务，通过集成SerpAPI Google Flights实现航班查询功能，支持单程和往返航班搜索，并提供MCP兼容的工具接口。

旅行与交通搜索工具 #航班搜索 #MCP协议 #AI工具 .Python

评分 : 2.5分

下载量 : 23

更新时间 : 2025-04-29

什么是MCP Flight Search?

MCP Flight Search是一个基于Model Context Protocol (MCP)的航班搜索服务。它允许AI模型通过结构化工具调用来查询航班信息，支持单程和往返航班搜索。

如何使用MCP Flight Search?

您可以通过启动MCP服务器并配置API密钥来使用该服务。AI模型可以通过MCP协议调用航班搜索工具获取航班信息。

适用场景

适用于需要集成航班搜索功能的AI应用，如旅行规划助手、行程安排工具等。

主要功能

航班搜索支持按出发地、目的地和日期搜索航班信息

MCP兼容完全符合Model Context Protocol标准，可与Claude等MCP兼容模型集成

SerpAPI集成通过SerpAPI获取Google Flights数据，提供丰富的航班信息

优势与局限性

优势

标准化接口：遵循MCP协议，易于与AI模型集成

灵活查询：支持单程和往返航班搜索

模块化设计：易于扩展和维护

局限性

依赖SerpAPI服务，需要配置API密钥

目前仅支持通过机场代码查询

返回的航班信息格式由SerpAPI决定

如何使用

安装服务

通过pip安装MCP Flight Search包

设置API密钥

配置SerpAPI密钥环境变量

启动服务器

运行MCP服务器

使用案例

搜索单程航班查询从纽约肯尼迪机场(JFK)到洛杉矶机场(LAX)的单程航班

搜索往返航班查询从北京首都机场(PEK)到上海虹桥机场(SHA)的往返航班

常见问题

如何获取SerpAPI密钥?

支持哪些机场代码格式?

可以自定义返回的航班信息字段吗?

🚀 基于 MCP 的航班搜索

这是一个使用 Model Context Protocol (MCP) 构建的航班搜索服务，展示了如何实现 MCP 工具以支持航班搜索功能，为航班搜索提供了高效、标准的解决方案。

🚀 快速开始

本项目是一个使用 Model Context Protocol (MCP) 构建的航班搜索服务，下面为你介绍如何快速启动它。

安装

# 从 PyPI 安装
pip install mcp-flight-search

# 或在开发模式下直接安装
pip install -e .

启动服务

启动 MCP 服务器：

# 使用命令行入口点
mcp-flight-search --connection_type http

# 或直接运行
python main.py --connection_type http

你还可以指定自定义端口：

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

设置环境变量

设置 SerpAPI 密钥为环境变量：

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

✨ 主要特性

符合 MCP 标准的航班搜索功能工具，便于与兼容 MCP 的模型集成。
集成使用 SerpAPI Google Flights，提供丰富的航班搜索数据。
支持单程和往返航班，满足不同出行需求。
丰富的日志记录功能，输出结构化日志，方便问题排查和系统监控。
模块化、易于维护的代码结构，方便后续功能扩展和优化。

📦 安装指南

# 从 PyPI 安装
pip install mcp-flight-search

# 或在开发模式下直接安装
pip install -e .

💻 使用示例

基础用法

启动 MCP 服务器：

# 使用命令行入口点
mcp-flight-search --connection_type http

# 或直接运行
python main.py --connection_type http

高级用法

指定自定义端口启动服务器：

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

📚 详细文档

MCP 工具

此包提供以下 Model Context Protocol 工具：

search_flights_tool：搜索机场之间的航班，参数包括：
- origin：出发机场代码（例如 ATL, JFK）
- destination：到达机场代码（例如 LAX, ORD）
- outbound_date：出发日期（YYYY-MM-DD）
- return_date：可选的返回日期（YYYY-MM-DD）
server_status：检查 MCP 服务器是否运行

项目结构

mcp-flight-search/
├── mcp_flight_search/
│   ├── __init__.py              # 包初始化和导出
│   ├── config.py                # 配置变量（API 密钥）
│   ├── models/
│   │   ├── __init__.py          # 模型包初始化
│   │   └── schemas.py           # Pydantic 模型（FlightInfo）
│   ├── services/
│   │   ├── __init__.py          # 服务包初始化
│   │   ├── search_service.py    # 主航班搜索逻辑
│   │   └── serpapi_client.py    # SerpAPI 客户端包装器
│   ├── utils/
│   │   ├── __init__.py          # 工具包初始化
│   │   └── logging.py           # 日志记录配置
│   └── server.py                # MCP 服务器设置和工具注册
├── main.py                      # 入口点
├── pyproject.toml               # Python 包装配置
├── LICENSE                      # MIT 许可证
└── README.md                    # 项目文档

🔧 技术细节

Model Context Protocol (MCP) 是由 Anthropic 开发的一项标准，允许 AI 模型通过定义工具描述、调用和响应的结构化格式来使用工具。此项目实现了 MCP 工具，可用于 Claude 和其他兼容 MCP 的模型。通过集成 SerpAPI Google Flights，项目能够获取丰富的航班搜索数据，并支持单程和往返航班搜索。同时，项目采用模块化的代码结构，各个模块分工明确，便于维护和扩展。日志记录功能输出结构化日志，方便对系统进行监控和问题排查。