mcp-tuniu-travel 1.0.1

途牛旅行助手MCP Server — 15个工具覆盖酒店/机票/火车票/景点门票全品类查询预订，途牛API实时数据直连

🧳 途牛旅行助手

途牛旅行助手MCP Server — 15个工具覆盖酒店、机票、火车票、景点门票全品类查询与预订，途牛API实时数据直连，零配置即装即用。

✨ 核心特性

▸ 全品类覆盖 — 酒店/机票/火车票/景点门票4大品类15个工具，从搜索到下单全流程闭环 ▸ 实时数据直连 — 途牛旅行API实时返回，价格、余票、房态均为最新数据 ▸ 完整预订链路 — 搜索→详情→下单→取消，每个品类都支持完整的预订流程 ▸ 安全代理架构 — 腾讯云SCF代理+SSL证书验证+域名白名单，数据传输安全可靠 ▸ 零配置即用 — MCP URL直连即用，配置PROXY_TOKEN即可接入

🛠 工具

hotel_search - 酒店搜索

按城市和日期搜索酒店，支持关键词、商圈筛选和翻页。返回酒店列表、价格、评分等信息。

参数：

▸ cityName（string，选填）：城市名称，如上海、北京（首页查询必填） ▸ checkInDate（string，选填）：入住日期，如2025-06-20 ▸ checkOutDate（string，选填）：离店日期，如2025-06-22 ▸ keyword（string，选填）：搜索关键词，如外滩、迪士尼 ▸ queryId（string，选填）：翻页查询ID（翻页查询时必填） ▸ pageNum（int，选填）：翻页页码，从1开始 ▸ districtName（string，选填）：区域/商圈名称，如浦东、春熙路

---

hotel_detail - 酒店详情

查看酒店房型和报价，返回preBookParam用于下单。

参数：

▸ hotelId（string，选填）：酒店ID（hotelId或hotelName至少填一个） ▸ hotelName（string，选填）：酒店名称，如上海外滩华尔道夫 ▸ checkInDate（string，选填）：入住日期 ▸ checkOutDate（string，选填）：离店日期

---

hotel_create_order - 酒店下单

基于hotel_detail返回的preBookParam预订酒店。

参数：

▸ hotelId（string，✅必填）：酒店ID ▸ roomId（string，✅必填）：房型ID ▸ preBookParam（string，✅必填）：预订参数，来自hotel_detail返回 ▸ checkInDate（string，✅必填）：入住日期 ▸ checkOutDate（string，✅必填）：离店日期 ▸ roomCount（int，✅必填）：房间数量 ▸ roomGuests（string，✅必填）：入住人信息JSON字符串 ▸ contactName（string，✅必填）：联系人姓名 ▸ contactPhone（string，✅必填）：联系人手机号

---

flight_search - 机票搜索

按出发/到达城市和日期搜索航班，支持单程/往返、多种排序。

参数：

▸ departureCityName（string，✅必填）：出发城市，如上海、北京 ▸ arrivalCityName（string，✅必填）：到达城市，如北京、成都 ▸ departureDate（string，✅必填）：出发日期，如2025-06-20 ▸ tripType（int，选填）：行程类型，0单程1往返 ▸ returnDate（string，选填）：返程日期，往返时必填 ▸ sortType（int，选填）：排序类型，0价格1时间2折扣

---

flight_cabin_detail - 机票舱位详情

查看航班各舱位价格和退改规则，返回cabinPriceId用于下单。

参数：

▸ departureCityName（string，✅必填）：出发城市 ▸ arrivalCityName（string，✅必填）：到达城市 ▸ departureDate（string，✅必填）：出发日期 ▸ flightNo（string，✅必填）：航班号，如MU5101

---

flight_booking_info - 机票预订信息

获取下单时必填字段说明和乘客信息格式要求。

参数： 无

---

flight_save_order - 机票下单

基于舱位详情的cabinPriceId预订机票。

参数：

▸ departureCityName（string，✅必填）：出发城市 ▸ arrivalCityName（string，✅必填）：到达城市 ▸ departureDate（string，✅必填）：出发日期 ▸ flightNo（string，✅必填）：航班号 ▸ cabinPriceId（string，✅必填）：舱位价格ID，来自flight_cabin_detail返回 ▸ tourists（string，✅必填）：乘客信息JSON字符串

---

flight_cancel_order - 机票取消订单

取消已创建的机票订单。

参数：

▸ orderId（string，✅必填）：订单ID

---

train_search - 火车票搜索

按出发/到达城市和日期搜索车次，支持6种排序方式。

参数：

▸ departureCityName（string，选填）：出发城市（首页查询必填） ▸ arrivalCityName（string，选填）：到达城市 ▸ departureDate（string，选填）：出发日期 ▸ queryId（string，选填）：翻页查询ID（翻页查询时必填） ▸ sortType（int，选填）：排序类型，0时间1价格2时长3出发早到晚4出发晚到早5到达早到晚

---

train_detail - 火车票车次详情

查看座位余票和价格，返回resId用于预订。

参数：

▸ departureStationName（string，✅必填）：出发站名称，如上海虹桥 ▸ arrivalStationName（string，✅必填）：到达站名称，如北京南 ▸ departureDate（string，✅必填）：出发日期 ▸ trainNum（string，✅必填）：车次号，如G2

---

train_book - 火车票预订

基于车次详情的resId预订火车票。

参数：

▸ resources（string，✅必填）：座位资源信息JSON字符串 ▸ adultTourists（string，✅必填）：成人乘客信息JSON字符串 ▸ contact（string，✅必填）：联系人信息JSON字符串

---

train_order_detail - 火车票订单详情

查看已创建的火车票订单详情。

参数：

▸ orderId（string，✅必填）：订单ID

---

train_cancel_order - 火车票取消订单

取消已创建的火车票订单。

参数：

▸ orderId（string，✅必填）：订单ID

---

ticket_query - 景点门票查询

按景点名称搜索门票价格和票种信息。

参数：

▸ scenic_name（string，✅必填）：景点名称，如故宫、迪士尼、长隆

---

ticket_create_order - 门票下单

基于门票查询的productId和resourceId预订景点门票。

参数：

▸ product_id（string，✅必填）：产品ID，来自ticket_query返回 ▸ resource_id（string，✅必填）：资源ID，来自ticket_query返回 ▸ depart_date（string，✅必填）：出行日期 ▸ adult_num（int，✅必填）：成人数量 ▸ contact_name（string，✅必填）：联系人姓名 ▸ contact_mobile（string，✅必填）：联系人手机号 ▸ tourist_1_name（string，✅必填）：游客1姓名 ▸ tourist_1_mobile（string，✅必填）：游客1手机号 ▸ tourist_1_cert_type（string，✅必填）：游客1证件类型，如身份证 ▸ tourist_1_cert_no（string，✅必填）：游客1证件号码

📝 使用示例

▸ "上海6月20到22日的酒店" → hotel_search搜索酒店列表 ▸ "这个酒店有什么房型" → hotel_detail查看房型报价 ▸ "北京到上海6月20日的机票" → flight_search搜索航班 ▸ "MU5101航班的舱位价格" → flight_cabin_detail查看舱位详情 ▸ "上海到北京6月20日的高铁" → train_search搜索车次 ▸ "故宫门票多少钱" → ticket_query查询景点门票

适用场景

• AI编程助手：在Cursor/Windsurf中直接调用旅行查询，为项目提供实时酒店/机票/火车票/门票数据
• 旅行智能体：给旅行AI Agent接上途牛能力，实现搜酒店→看房型→下单全流程闭环
• 对话式旅行应用：自然语言输入即可获得酒店/机票/火车票/门票的结构化数据
• 与其他旅行MCP联动：搭配高德/飞猪等MCP服务，构建一站式旅行方案