MCP Flight Search

🚀 基於 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，項目能夠獲取豐富的航班搜索數據，並支持單程和往返航班搜索。同時，項目採用模塊化的代碼結構，各個模塊分工明確，便於維護和擴展。日誌記錄功能輸出結構化日誌，方便對系統進行監控和問題排查。

📄 許可證

此項目根據 MIT 許可證發佈，詳細信息請參閱 LICENSE 文件。

作者

瞭解更多關於 AI/ML 和生成式 AI 的文章，請訪問作者的 Medium 博客：https://medium.com/@arjun-prabhulal