🧳 途牛旅行助手
途牛旅行助手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服务,构建一站式旅行方案
Metadata
Release files for mcp-tuniu-travel 1.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_tuniu_travel-1.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / mcp_tuniu_travel-1.1.1-py3-none-any.whl
| Download URL | mcp_tuniu_travel-1.1.1-py3-none-any.whl |
|---|---|
| Size | 12.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3f905c3395b063405d5cb7d30ebd4e9d0e808b900b80f26302eb2b0529d42c18
|
|
BLAKE2b-256 checksum How to use checksums |
b629f91c1aa303e85503354454c94d3d27cd40a53114742f03c14e682204f85f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|
Security for mcp-tuniu-travel 1.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.