Variflight MCP Server

Variflight MCP 服务

用于 VariFlight 航班信息服务的模型上下文协议（MCP）服务实现。此服务提供各种工具，用于查询航班信息、天气数据和航班舒适度指标。

此软件包是 VariFlight AI 开放平台上的 VariFlight Aviation MCP stdio 发行版。完整文档（包括客户端设置、工具参考和定价）请参阅：ai.variflight.com/docs/aviation（中文）。

Variflight API 密钥

要使用 Variflight MCP 服务，你需要一个 Variflight API 密钥。请在 ai.variflight.com 注册并在控制台中创建密钥；新账户可获赠 ¥50 试用额度。

远程服务

相同的工具也可通过可流式传输的 HTTP 作为远程 MCP 服务使用，无需本地进程：

claude mcp add --transport http variflight-aviation https://ai.variflight.com/servers/aviation/mcp \
  --header "X-API-Key: YOUR_API_KEY"

支持 OAuth 2.1 的客户端可以在无需密钥的情况下添加 https://ai.variflight.com/servers/aviation/mcp，并在出现提示时登录。

安装

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

可用工具

1. 按出发地和目的地搜索航班

按城市或机场代码搜索指定日期的直飞航班。请使用 BJS 这样的城市代码或 PEK 这样的精确机场代码，但同一侧不可混用城市代码和机场代码：

searchFlightsByDepArr({
  dep: "PEK",  // Beijing
  arr: "SHA",  // Shanghai
  date: "2024-03-20"
})

2. 按航班号搜索航班

按航班号和日期搜索指定航班：

searchFlightsByNumber({
  fnum: "MU2157",
  date: "2024-03-20"
})

3. 获取航班中转信息

搜索出发城市和到达城市之间的中转航班选项：

getFlightTransferInfo({
  depcity: "BJS",
  arrcity: "LAX",
  depdate: "2024-03-20"
})

searchFlightsByDepArr 和 getFlightTransferInfo 也接受可选的分页参数。繁忙航线可能会返回数十条结果，且每条结果都包含许多字段，因此可以使用这些参数来缩小响应内容：

• limit：要返回的结果数量上限
• offset：要跳过的结果数量；传入上一条响应中的 next_offset 可获取下一页。每一页都是单独计费的调用。
• detail："summary" 仅返回每条结果的核心字段；"full"（默认值）返回所有字段

设置其中任意参数时，响应还会包含 total、offset、returned，如果还有更多结果，也会包含 next_offset。不设置这些参数时，响应保持不变。

searchFlightsByDepArr({
  depcity: "BJS",
  arrcity: "SHA",
  date: "2024-03-20",
  limit: 20,
  detail: "summary"
})

4. 航班舒适度指数

获取已知航班的舒适度相关详情，例如准点率、机型、客舱布局、餐食和娱乐设施：

flightHappinessIndex({
  fnum: "MU2157",
  date: "2024-03-20"
})

5. 实时飞机位置

使用飞机注册编号（也称为机尾号）跟踪实时航班位置：

getRealtimeLocationByAnum({
  anum: "B2021"
})

6. 机场天气预报

获取机场未来 3 天的天气预报：

getFutureWeatherByAirport({
  airport: "PEK"
})

7. 搜索航班行程

获取自然语言摘要，其中包含推荐的航班选项、总体最低价格、最短时长和若干建议行程：

searchFlightItineraries({
  depCityCode: "BJS",  // Beijing
  arrCityCode: "SHA",  // Shanghai
  depDate: "2025-04-20"
})

8. 按城市获取航班价格

获取两个城市之间结构化的原始特价航班数据，其中每个航班都会返回各舱位的价格：

getFlightPriceByCities({
  dep_city: "BJS",  // Beijing
  arr_city: "SHA",  // Shanghai
  dep_date: "2026-04-20"
})

许可证

ISC 许可证——详情请参阅 LICENSE。

作者

Variflight (https://ai.variflight.com)

版本

当前版本：1.1.0