Metadata-Version: 2.4
Name: mcp-tuniu-travel
Version: 1.0.1
Summary: 途牛旅行助手MCP Server — 15个工具覆盖酒店/机票/火车票/景点门票全品类查询预订，途牛API实时数据直连
Author: Tuniu Travel MCP Team
License-Expression: MIT
Keywords: flight,hotel,mcp,ticket,train,travel,tuniu,旅行,机票,火车票,途牛,酒店,门票
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Other/Nonlisted Topic
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.9.2
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🧳 途牛旅行助手

途牛旅行助手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服务，构建一站式旅行方案
