Skip to main content

🧳 途牛旅行助手

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_tuniu_travel-1.1.0.tar.gz (10.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_tuniu_travel-1.1.0-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file mcp_tuniu_travel-1.1.0.tar.gz.

File metadata

  • Download URL: mcp_tuniu_travel-1.1.0.tar.gz
  • Upload date:
  • Size: 10.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for mcp_tuniu_travel-1.1.0.tar.gz
Algorithm Hash digest
SHA256 c0fb91acf48e2c6ee1c528d0366314001c937a6c7c8cffc2ee62f84d8f492687
MD5 397f88f5558c42ed28f75123f8729a18
BLAKE2b-256 b014fcfe880b63cb4ad58270ec31582ac2028ea7da699caebc3ea96dac395cd3

See more details on using hashes here.

File details

Details for the file mcp_tuniu_travel-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_tuniu_travel-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7587cbc9b9fdbd48eff44427966431efa24f2be7532d5b7c77a9e12b9f2610c2
MD5 48b782da0fae49edddbc53498f5a3830
BLAKE2b-256 5cf25e4106652804e9321dc7503e56e901f71360fa07fe101b9b0358501f61cf

See more details on using hashes here.

Release history Release notifications | RSS feed

1.2.0

1 file

This release

1.1.0 This release

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page