travelpayouts-mcp

Travelpayouts MCP — 面向 AI 助手的航班和酒店搜索

如果你想让 Claude 或其他 AI 助手查找某条航线的最低价航班、显示灵活日期的价格日历、查询机场或航空公司代码，或搜索酒店，那么这就是你要找的工具。Travelpayouts（Aviasales）API 上提供 13 个工具：航班搜索、价格日历、酒店搜索、机场／航空公司／城市查询、直飞航线和灵活日期价格。

安装

npm install -g @theyahia/travelpayouts-mcp

也可以直接使用 npx：

npx @theyahia/travelpayouts-mcp

环境变量

变量	必填	说明
TRAVELPAYOUTS_TOKEN	是	从 Travelpayouts 获取的 API 令牌

Claude Desktop 配置

{
  "mcpServers": {
    "travelpayouts": {
      "command": "npx",
      "args": ["-y", "@theyahia/travelpayouts-mcp"],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "your-token"
      }
    }
  }
}

工具（13 个）

航班（8 个）

工具	说明
search_flights_prices	按航线、日期和货币搜索低价航班
get_cheapest_month	查找整个月的最低价航班
get_calendar_prices	显示每日最低价格的价格日历
get_popular_directions	查询某个城市出发的热门航线及价格
get_airline_directions	查询特定航空公司运营的航线
get_special_offers	查询当前所有航线的航班特惠
get_direct_routes	仅搜索两个城市之间的直飞航班
get_nearest_prices	查询目标日期前后 ±N 天的价格（灵活出行）

酒店（2 个）

工具	说明
search_hotels	按城市、日期和入住人数搜索酒店
get_hotel_prices	查询指定酒店 ID 的价格

查询（3 个）

工具	说明
lookup_airports	按名称或 IATA 代码搜索／自动补全机场
lookup_airlines	按名称或 IATA／ICAO 代码搜索航空公司
lookup_cities	按名称或 IATA 代码搜索／自动补全城市

身份验证

通过 X-Access-Token 请求头或查询参数传递 API 令牌。遇到 429（速率限制）和 5xx（服务端错误）时会使用指数退避策略重试。

演示提示词

1. “查找 6 月莫斯科飞往伊斯坦布尔的最低价航班” 使用 lookup_cities 查询 IATA 代码，然后使用 get_cheapest_month 查找当月的最佳优惠。

2. “现在从圣彼得堡出发的热门目的地有哪些？” 使用 get_popular_directions，以 LED 为出发地，显示热门航线和当前价格。

3. “搜索索契 7 月 10 日至 17 日的酒店，入住人数为 2 位成人，然后查找从莫斯科飞往那里的航班” 使用 search_hotels 查找住宿选项，然后使用 search_flights_prices 搜索日期匹配的航班。

4. “我想在 3 月 15 日前后从莫斯科飞往迪拜，如果前后 ±3 天更便宜也可以” 使用 get_nearest_prices 比较以 3 月 15 日为中心的 7 个日期的价格。

5. “只查找莫斯科飞往明斯克的直飞航班” 使用 get_direct_routes 并启用 direct=true 筛选条件。

开发

npm install
npm run dev          # Run with tsx
npm test             # Run tests
npm run build        # Compile TypeScript

许可证

MIT

---

Telegram： @vhodvai