使用说明

项目简介

'航班管家 MCP 服务器 (variflight-mcp)' 是一个基于 Model Context Protocol (MCP) 实现的后端服务，专注于提供全面的航班信息查询能力。它集成了航班管家强大的航空数据，通过标准化的 MCP 协议，为各类 LLM 应用提供即插即用的航班信息上下文服务。

主要功能点

航班查询: 支持通过出发地/目的地、航班号等多种方式查询航班的实时状态、计划信息。
天气信息: 提供机场未来三天的天气预报，帮助用户了解出行当天的天气情况。
航班舒适度: 提供航班舒适度指数，包含航班准点率、机上设施、健康安全协议等信息，辅助用户进行更明智的航班选择。
飞机实时定位: 根据飞机注册号查询飞机当前的实时位置。
机票搜索: 搜索可购买的机票方案和最低价格。
日期工具: 提供获取今天日期的工具，方便在工具调用中处理日期参数。

所有工具均返回 JSON 格式的航班或天气数据，方便 LLM 理解和使用。

安装步骤

本 MCP 服务器以 npm 包的形式发布，可以通过 'npx' 命令直接运行，无需手动安装。

服务器配置

要将 '航班管家 MCP 服务器' 集成到 MCP 客户端，您需要在客户端的 'mcpServers' 配置中添加以下 JSON 配置。请务必将 'your_api_key_here' 替换为您在航班管家 MCP 平台申请的 API Key。

{
  "mcpServers": {
    "variflight": {
      "command": "npx",
      "args": [
        "-y",
        "@variflight-ai/variflight-mcp"
      ],
      "env": {
        "VARIFLIGHT_API_KEY": "your_api_key_here"
      }
    }
  }
}

配置参数说明:

server name: 'variflight' - 服务器名称，可以自定义，用于在 MCP 客户端中引用。
command: 'npx' - Node.js 包执行器，用于运行 npm 包。
args:
- '-y' - 'npx' 参数，表示自动确认安装包。
- '@variflight-ai/variflight-mcp' - 要执行的 npm 包名称，即 '航班管家 MCP 服务器' 的包名。
env:
- 'VARIFLIGHT_API_KEY': [必填] 航班管家 API Key，用于访问航班管家 API 接口。请替换为您的真实 API Key。

注意: MCP 客户端会根据此配置启动 '航班管家 MCP 服务器'，并与之建立连接。

基本使用方法

成功配置并启动 '航班管家 MCP 服务器' 后，您可以在 MCP 客户端中使用以下工具来查询航班信息:

searchFlightsByDepArr: 根据出发地和目的地查询航班。
- 参数示例: '{"dep": "PEK", "arr": "SHA", "date": "2024-03-20"}' (查询 2024 年 3 月 20 日北京到上海的航班)
- 支持机场三字码 (如 PEK, SHA) 和城市三字码 (如 BJS, SHA)。
- 日期格式为 YYYY-MM-DD。
searchFlightsByNumber: 根据航班号查询航班。
- 参数示例: '{"fnum": "MU2157", "date": "2024-03-20"}' (查询 2024 年 3 月 20 日 MU2157 航班)
- 航班号需包含航空公司代码 (如 MU2157)。
getFlightTransferInfo: 查询城市间的中转航班信息。
- 参数示例: '{"depcity": "BJS", "arrcity": "LAX", "depdate": "2024-03-20"}' (查询 2024 年 3 月 20 日北京到洛杉矶的中转航班)
flightHappinessIndex: 获取航班舒适度指数。
- 参数示例: '{"fnum": "MU2157", "date": "2024-03-20"}' (查询 2024 年 3 月 20 日 MU2157 航班的舒适度信息)
getRealtimeLocationByAnum: 根据飞机注册号查询飞机实时位置。
- 参数示例: '{"anum": "B2021"}' (查询注册号为 B2021 的飞机的实时位置)
getFutureWeatherByAirport: 获取机场未来三天的天气预报。
- 参数示例: '{"airport": "PEK"}' (查询北京首都机场未来三天的天气)
searchFlightItineraries: 搜索机票方案和最低价格。
- 参数示例: '{"depCityCode": "BJS", "arrCityCode": "SHA", "depDate": "2025-04-20"}' (搜索 2025 年 4 月 20 日北京到上海的机票)
getTodayDate: 获取今天的日期。
- 无需参数。

注意: 所有工具的参数和返回值均为 JSON 格式。请参考工具的描述和参数定义，在 MCP 客户端中正确调用。

API Key

使用 '航班管家 MCP 服务器' 需要有效的航班管家 API Key。请访问航班管家 MCP 平台申请。

关键词