🚀 找到正确的航班

本项目提供了一系列工具，可帮助你方便快捷地查找各种类型的航班信息，支持单程、往返和多城市航班搜索，还能获取航班详细信息，同时具备健壮的错误处理机制。

🚀 快速开始

你可以使用本项目提供的工具来查找各种复杂度的航班，以下是一些使用示例：

• "查找2025年1月7日从SFO到纽约的单程航班，2名成人商务舱"
• "查找往返于洛杉矶和伦敦的航班，出发日期为2025年1月8日，返回日期为2025年1月15日"
• "计划一次从纽约到巴黎的多城市旅行，2025年1月7日出发，然后前往罗马2025年1月10日，最后返回纽约2025年1月15日"
• "2025年1月7日至2025年1月15日期间，2名成人经济舱从SFO到LAX的最便宜航班是什么？"
• 你甚至可以搜索在多天内往返的航班。目前推荐用于单程或往返航班。例如："查找2025年1月7日至2025年1月10日期间，2名成人经济舱从SFO到LAX的最便宜航班"

✨ 主要特性

• 支持三种类型的航班搜索：单程航班、往返航班、多个城市航班。
• 可获取特定航班报价的详细信息。
• 具备健壮的错误处理功能，能应对多种异常情况。

💻 使用示例

基础用法

@mcp工具()
异步函数搜索航班（参数：FlightSearch）-> str：
    """根据参数查找航班。"""

支持三种类型的航班：

• 单程航班
• 往返航班
• 多个城市航班

参数包括：

• type: 航班类型 ('one_way', 'round_trip', 'multi_city')
• origin: 出发地机场代码
• destination: 目的地机场代码
• departure_date: 出发日期 (YYYY-MM-DD)
• 可选参数:
  • return_date: 返程日期（用于往返航班）
  • adults: 成人乘客数量
  • cabin_class: 偏好的舱位等级
  • departure_time: 具体的出发时间范围
  • arrival_time: 具体的到达时间范围
  • max_connections: 最大连接次数

高级用法

@mcp工具()
异步函数获取offer_details（参数：OfferDetails）-> str：
    """获取特定航班报价的详细信息。"""

使用唯一的ID获取特定航班报价的全面详细信息。

@mcp工具(name="search_multi_city")
异步函数搜索multi_city（参数：MultiCityRequest）-> str：
    """搜索多城市航班。"""

专门用于复杂多城市航班行程的工具。

参数包括：

• segments: 航班段落列表
• adults: 成人乘客数量
• cabin_class: 偏好的舱位等级
• max_connections: 最大连接次数

📚 详细文档

响应格式

工具返回JSON格式的响应，包括：

• 航班报价详细信息
• 价格信息
• 路线详细信息
• 承运人信息
• 连接详细信息

错误处理

该服务包含健壮的错误处理功能，包括：

• API请求失败
• 无效机场代码
• 缺失或无效API密钥
• 网络超时
• 无效搜索参数

性能注意事项

• 每次航班搜索最多返回10个结果。
• 复杂的多城市行程可能需要更长的处理时间。

通过遵循这些指南，你可以有效地使用提供的工具来查找和管理航班。