Flights MCP

🚀 ✈️ 航班MCP服務器

這是一個模型上下文協議（MCP）服務器，藉助Aviasales航班搜索API提供航班搜索功能。通過該服務器，你可以搜索航班、篩選結果、獲取詳細的航班信息並生成預訂鏈接。

點擊查看相關資源

🚀 快速開始

你可以選擇使用遠程MCP服務器，也可以部署自己的實例：

• 遠程MCP
  有一個公共實例可通過以下地址訪問：
  https://findflights.me/sse
  此服務器使用SSE傳輸協議，無需設置即可直接使用。

  ⚠️ 重要提示：目前並非所有的大語言模型（LLM）客戶端都支持遠程MCP連接。例如，Claude.ai僅在Pro+計劃中支持遠程MCP集成。

• 自行部署
  如果你希望運行自己的服務器，請遵循安裝指南部分的說明進行操作。

  ⚠️ 重要提示：要部署自己的服務器，你必須獲取Aviasales API密鑰和標記ID。

✨ 主要特性

• 航班搜索：支持單程、往返和多城市航班搜索。
• 高級篩選：可根據價格、時長、航空公司、出發/到達時間和經停次數等條件篩選結果。
• 多種排序選項：支持按價格、出發時間、到達時間或時長進行排序。
• 詳細航班信息：提供全面的航班詳情，包括行李額度和航空公司信息。
• 預訂鏈接：為選定的航班生成預訂鏈接。
• 本地存儲：已執行的搜索會存儲在本地，以便大語言模型（LLM）無需等待即可訪問過往搜索記錄。
• 多種MCP傳輸選項：支持標準輸入輸出（stdio）、HTTP和SSE傳輸協議。

📦 安裝指南

前提條件

• Aviasales API密鑰
• Python 3.12 或更高版本
• UV包管理器

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd flights-mcp

3. 設置環境變量（請參閱環境變量部分）
4. 運行服務器

uv run src/flights-mcp/main.py

服務器將綁定到 0.0.0.0，可通過主機的所有網絡接口進行訪問。

🔧 環境變量

以下是所需的環境變量：

📚 詳細文檔

MCP工具

服務器提供以下MCP工具：

典型使用模式

1. 搜索航班：使用search_flights()方法，可多次調用以搜索靈活日期的航班。
2. 篩選和瀏覽選項：使用get_flight_options()方法，這是一個輕量級工具，可多次調用並使用不同的篩選和排序選項。
3. 獲取詳細信息：使用get_flight_option_details()方法，獲取用戶首選選項的詳細信息。
4. 生成預訂鏈接：僅當用戶確認預訂意向時，使用request_booking_link()方法生成預訂鏈接。

📄 支持與反饋

• MCP服務器問題：請在此倉庫中提交問題。
• MCP協議問題：請參閱模型上下文協議文檔。