关键词

航班查询机票搜索旅行规划Duffel API航班预订助手

Find Flights MCP Server 使用说明

项目简介

Find Flights MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 LLM 客户端（如 Claude）提供强大的航班搜索能力。它通过集成 Duffel API，能够访问实时的航班数据，并以结构化的 JSON 格式返回机票信息。用户可以通过自然语言指令，在 LLM 对话中轻松完成复杂的航班查询和比较，无需手动操作复杂的机票预订网站。

主要功能点

  • 航班搜索: 支持查询单程、往返和多城市行程的机票。
  • 灵活的搜索条件: 支持出发地、目的地、出发日期、返回日期（往返）、舱位等级、乘客人数等多种搜索条件。
  • 详细航班信息: 返回包含价格、航线、航空公司、中转信息等详细的航班报价，方便用户进行选择。
  • 多日价格搜索: 允许在一定日期范围内搜索航班，帮助用户找到价格最优的出行方案。
  • 支持复杂行程: 特别适合需要规划多城市旅行或复杂航线组合的用户。

安装步骤

  1. 克隆仓库：首先，将 Find Flights MCP Server 仓库克隆到本地： 
    git clone https://github.com/ravinahp/flights-mcp
cd flights-mcp
  2. 安装依赖：使用 'uv' 工具安装项目依赖。请确保已安装 'uv'。 
    uv sync
  3. 获取 Duffel API Key：
    • 访问 Duffel 官网 注册账号。
    • 获取 Duffel API Live Key。首次使用推荐先使用 Test API Key ('duffel_test') 进行测试。
    • 详细的 API Key 获取步骤请参考仓库 README.md 文档的 "Getting Your Duffel API Key" 部分。

服务器配置

要将 Find Flights MCP Server 添加为 Claude Desktop 的 MCP 服务器，需要修改 Claude 的配置文件 'claude_desktop_config.json'。

配置文件位置：

  • MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

添加服务器配置： 在 'claude_desktop_config.json' 文件中添加以下 JSON 配置。请根据实际情况修改 'command.args' 中的路径和 'env.DUFFEL_API_KEY_LIVE' 的 API Key。

{
    "flights-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/flights-mcp",  // 替换为你的 flights-mcp 仓库在本地的实际路径
            "run",
            "flights-mcp"
        ],
        "env": {
            "DUFFEL_API_KEY_LIVE": "your_duffel_api_key_here"  // 替换为你的 Duffel Live API Key，如果使用测试 Key，则填入 "duffel_test"
        }
    }
}

配置参数说明：

  • 'server name': 'flights-mcp' (服务器名称，在 Claude 客户端中用于标识和调用)
  • 'command': 'uv' (启动服务器的命令，这里使用 uv 运行器)
  • 'args': 启动参数，包括：
    • '--directory': '/path/to/flights-mcp' (指向 flights-mcp 仓库根目录的路径，请务必替换为你的实际路径)
    • 'run': 运行 uv 脚本的子命令
    • 'flights-mcp': 要运行的脚本名称 (对应仓库中的 'flights-mcp' 入口)
  • 'env': 环境变量配置
    • 'DUFFEL_API_KEY_LIVE': 'your_duffel_api_key_here' (Duffel API Live Key，请务必替换为你的实际 API Key，或者使用 '"duffel_test"' 作为测试 Key)

基本使用方法

配置完成后，在 Claude 或其他支持 MCP 协议的 LLM 客户端中，即可通过自然语言指令调用 Find Flights MCP Server 的功能。

示例指令：

  • "查找明天从旧金山 (SFO) 到洛杉矶 (LAX) 的单程经济舱机票"
  • "搜索下周从纽约 (JFK) 到伦敦 (LHR) 的往返机票，2 位成人"
  • "帮我规划一个从巴黎 (CDG) 到罗马 (FCO) 再到柏林 (BER) 的多城市旅行的航班，日期分别为 12 月 20 日和 12 月 25 日"
  • "查询 1 月 7 日到 1 月 15 日期间，从旧金山 (SFO) 到 洛杉矶 (LAX) 最便宜的经济舱机票，2 位成人"

注意：

  • 请确保替换配置中的路径和 API Key 为你自己的实际信息。
  • 首次体验可以使用 Duffel 的测试 API Key ('duffel_test')，无需完成 Duffel 账户的完整验证流程。
  • 详细的功能和参数说明，请参考仓库的 README.md 文档。

信息

分类

网页与API

访问项目