tripmatch-mcp

🚀 飞常准行程匹配MCP服务器

飞常准行程匹配MCP服务器提供了一组用于查询航班和火车信息的工具。

🚀 快速开始

✨ 主要特性

飞常准行程匹配MCP服务器具备以下主要特性：

• 提供多种查询工具，可查询航班和火车信息。
• 支持按出发地、目的地、航班号、日期等多种条件查询航班信息。
• 提供获取今日日期、机场天气预报等实用工具。

📦 安装指南

要使用飞常准行程匹配MCP服务器，你需要有一个飞常准API密钥。你可以从这里获取。

以下是安装配置示例：

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

💻 使用示例

基础用法

以下是各个工具的使用示例：

• 按出发地和目的地搜索航班： 按日期搜索机场或城市之间的航班。对于有多个机场的城市，使用depcity和arrcity参数；否则使用dep和arr参数。日期必须为YYYY-MM-DD格式。如果要查询今天的日期，使用getTodayDate工具。所有机场/城市代码必须是有效的IATA 3字母代码（例如，北京的城市代码为BJS，北京首都机场代码为PEK）。

searchFlightsByDepArr({
  dep: "PEK",      // 出发机场IATA 3字母代码（可选）
  depcity: "BJS", // 出发城市IATA 3字母代码（可选）
  arr: "SHA",      // 到达机场IATA 3字母代码（可选）
  arrcity: "SHA",  // 到达城市IATA 3字母代码（可选）
  date: "2024-03-20" // 航班日期，格式为YYYY-MM-DD
})

• 按航班号搜索航班： 按航班号和日期搜索航班。航班号应包含航空公司代码（例如，MU2157、CZ3969）。dep和arr是可选的，如果你不知道可以留空。日期格式为YYYY-MM-DD。重要提示：如果要查询今天的日期，你必须使用getTodayDate工具，而不是硬编码任何日期。机场代码（可选）应为IATA 3字母代码。

searchFlightsByNumber({
  fnum: "MU2157", // 包含航空公司代码的航班号
  date: "2024-03-20", // 航班日期，格式为YYYY-MM-DD
  dep: "HFE",     // 出发机场IATA 3字母代码（可选）
  arr: "CAN"      // 到达机场IATA 3字母代码（可选）
})

• 获取航班和火车换乘信息： 按出发城市、到达城市和出发日期获取航班和火车换乘信息。日期格式为YYYY-MM-DD。重要提示：如果要查询今天的日期，你必须使用getTodayDate工具，而不是硬编码任何日期。机场代码应为IATA 3字母代码。

getFlightAndTrainTransferInfo({
  depcity: "BJS", // 出发机场IATA 3字母代码
  arrcity: "LAX", // 到达机场IATA 3字母代码
  depdate: "2024-03-20" // 航班日期，格式为YYYY-MM-DD
})

• 航班幸福指数： 当你需要以下相关信息时使用此工具：详细的航班比较（准点率、便利设施、客舱规格）、航空旅行的健康安全协议、行李限额验证、环境影响评估、飞机配置可视化、注重舒适度的行程规划（座位尺寸、娱乐设施、餐饮）等。

flightHappinessIndex({
  fnum: "MU2157", // 包含航空公司代码的航班号
  date: "2024-03-20", // 航班日期，格式为YYYY-MM-DD
  dep: "HFE",     // 出发机场IATA 3字母代码（可选）
  arr: "CAN"      // 到达机场IATA 3字母代码（可选）
})

• 获取今日日期： 获取当地时区的今日日期（YYYY-MM-DD格式）。每当你需要今日日期时使用此工具 - 切勿硬编码日期。

getTodayDate({})

• 机场天气预报： 按机场IATA 3字母代码获取机场未来3天（今天、明天、后天）的天气预报。机场代码应为IATA 3字母代码（例如，北京为PEK，上海为SHA，广州为CAN，合肥为HFE）。

getFutureWeatherByAirport({
  airport: "PEK" // 机场IATA 3字母代码
})

• 搜索火车票： 按特定日期搜索两个城市之间的火车票。日期必须为YYYY-MM-DD格式。

searchTrainTickets({
  from: "合肥", // 出发城市名称
  to: "北京",   // 到达城市名称
  date: "2024-03-25" // 旅行日期，格式为YYYY-MM-DD
})

• 按城市获取航班价格： 按出发城市、到达城市和出发日期获取航班价格信息。所有城市代码必须是有效的IATA 3字母代码（例如，合肥为HFE，广州为CAN）。日期必须为YYYY-MM-DD格式。

getFlightPriceByCities({
  dep_city: "HFE", // 出发城市IATA 3字母代码
  arr_city: "CAN", // 到达城市IATA 3字母代码
  dep_date: "2024-03-25" // 出发日期，格式为YYYY-MM-DD
})

• 搜索火车站： 按关键字搜索火车站。

searchTrainStations({
  query: "北京" // 搜索火车站的关键字
})

📄 许可证

本项目采用ISC许可证，详情请参阅LICENSE。

👤 作者

飞常准 (https://ai.variflight.com)

📌 版本

当前版本：0.0.2