途牛旅行
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"TuniuTravel": {
"args": [
"mcp-tuniu-travel==1.1.0"
],
"command": "uvx",
"env": {}
}
}
}可用工具 （17 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
hotel_search 7 个参数
途牛酒店搜索：按城市和日期搜索酒店，支持关键词、商圈筛选和翻页。返回酒店列表、价格、评分及酒店图片。首页查询需传cityName，翻页查询需传queryId和pageNum。
该工具无需必填参数，直接调用即可
hotel_detail 4 个参数
途牛酒店详情：查看酒店房型和报价，返回preBookParam用于下单。结果含酒店图片、房型图片、入住政策和各价格方案。需传hotelId或hotelName。
该工具无需必填参数，直接调用即可
hotel_create_order 9 个参数 需填 9 项
途牛酒店下单：基于hotel_detail返回的preBookParam预订酒店。需先调用hotel_search和hotel_detail获取必要参数。
必填参数：hotelId、roomId、preBookParam、checkInDate、checkOutDate、roomCount、roomGuests、contactName、contactPhone
flight_search 6 个参数 需填 3 项
途牛机票搜索：按出发/到达城市和日期搜索航班，支持单程/往返、多种排序。返回航班号、起降时间、价格等信息。
必填参数：departureCityName、arrivalCityName、departureDate
flight_cabin_detail 4 个参数 需填 4 项
途牛机票舱位详情：查看航班各舱位价格和退改规则，返回cabinPriceId用于下单。需先通过flight_search获取航班号。
必填参数：departureCityName、arrivalCityName、departureDate、flightNo
flight_booking_info
途牛机票预订信息：获取下单时必填字段说明和乘客信息格式要求，下单前建议先调用此工具了解必填项。
该工具无需必填参数，直接调用即可
flight_save_order 6 个参数 需填 6 项
途牛机票下单：基于舱位详情的cabinPriceId预订机票。需先调用flight_search获取航班号，flight_cabin_detail获取cabinPriceId。
必填参数：departureCityName、arrivalCityName、departureDate、flightNo、cabinPriceId、tourists
flight_cancel_order 1 个参数 需填 1 项
途牛机票取消订单：取消已创建的机票订单，需提供订单ID。
必填参数：orderId
train_search 5 个参数
途牛火车票搜索：按出发/到达城市和日期搜索车次，支持6种排序方式。返回车次、时间、价格、余票等信息。首页查询需传departureCityName，翻页查询需传queryId。
该工具无需必填参数，直接调用即可
train_detail 4 个参数 需填 4 项
途牛火车票车次详情：查看座位余票和价格，返回resId用于预订。需先通过train_search获取车次号。
必填参数：departureStationName、arrivalStationName、departureDate、trainNum
train_book 3 个参数 需填 3 项
途牛火车票预订：基于车次详情的resId预订火车票。需先调用train_search和train_detail获取必要参数。
必填参数：resources、adultTourists、contact
train_order_detail 1 个参数 需填 1 项
途牛火车票订单详情：查看已创建的火车票订单详情，包括车次、座位、乘客等信息。
必填参数：orderId
train_cancel_order 1 个参数 需填 1 项
途牛火车票取消订单：取消已创建的火车票订单，需提供订单ID。
必填参数：orderId
ticket_query 1 个参数 需填 1 项
途牛景点门票查询：按景点名称搜索门票价格和票种信息，返回productId和resourceId用于下单。
必填参数：scenic_name
ticket_create_order 10 个参数 需填 10 项
途牛门票下单：基于门票查询的productId和resourceId预订景点门票。需先调用ticket_query获取产品信息。
必填参数：product_id、resource_id、depart_date、adult_num、contact_name、contact_mobile、tourist_1_name、tourist_1_mobile、tourist_1_cert_type、tourist_1_cert_no
cruise_search 5 个参数
途牛邮轮搜索：按日期范围和航线搜索邮轮产品，返回邮轮名称、价格、天数、品牌及邮轮图片。不填日期默认未来30天。
该工具无需必填参数，直接调用即可
holiday_search 10 个参数
途牛度假产品搜索：搜索跟团游、自由行等度假产品，支持按目的地、天数、价格、产品类型筛选。返回产品名称、价格、天数等信息。
该工具无需必填参数，直接调用即可
服务介绍
🧳 途牛旅行助手
途牛旅行全品类一站式MCP服务，15个工具覆盖酒店/机票/火车票/景点门票查询预订全流程，途牛API实时数据直连。
✨ 核心特性
▸ 15个工具覆盖酒店搜索/详情/下单、机票搜索/舱位/预订/取消、火车票搜索/详情/预订/订单/取消、景点门票查询/下单全品类全流程
▸ 途牛API实时数据直连，价格库存实时更新
▸ 零配置即装即用，无需额外申请Key
▸ 结构化返回，适配各类Agent框架和IDE
🛠 工具
hotel_search - 酒店搜索
按城市、日期、关键词、商圈搜索酒店列表，返回酒店名称、价格、评分、预订链接。
参数：
▸ cityName（string，✅必填）：城市名，如"上海""北京"
▸ checkInDate（string，✅必填）：入住日期，如"2025-07-01"
▸ checkOutDate（string，✅必填）：离店日期，如"2025-07-03"
▸ keyword（string，选填）：关键词，如"外滩""迪士尼"
▸ pageIndex（int，选填）：页码，默认1
hotel_detail - 酒店详情
查看酒店房型报价，获取下单所需参数。
参数：
▸ hotelId（string，✅必填）：酒店ID（从hotel_search结果获取）
▸ checkInDate（string，✅必填）：入住日期
▸ checkOutDate（string，✅必填）：离店日期
hotel_create_order - 酒店下单
预订酒店房间，提交订单。
参数：
▸ hotelId（string，✅必填）：酒店ID
▸ roomId（string，✅必填）：房型ID（从hotel_detail结果获取）
▸ checkInDate（string，✅必填）：入住日期
▸ checkOutDate（string，✅必填）：离店日期
▸ guestName（string，✅必填）：入住人姓名
▸ guestPhone（string，✅必填）：入住人手机号
flight_search - 机票搜索
按出发/到达城市和日期搜索航班，返回航班号、起降时间、价格。
参数：
▸ departureCity（string，✅必填）：出发城市，如"上海"
▸ arrivalCity（string，✅必填）：到达城市，如"北京"
▸ departureDate（string，✅必填）：出发日期，如"2025-07-01"
flight_cabin_detail - 机票舱位详情
查看各舱位价格和退改规则。
参数：
▸ flightId（string，✅必填）：航班ID（从flight_search结果获取）
▸ departureDate（string，✅必填）：出发日期
flight_booking_info - 机票预订信息
获取下单必填字段说明。
参数：
▸ flightId（string，✅必填）：航班ID
flight_save_order - 机票下单
预订机票，提交订单。
参数：
▸ flightId（string，✅必填）：航班ID
▸ cabinClass（string，✅必填）：舱位等级
▸ passengerName（string，✅必填）：乘机人姓名
▸ passengerPhone（string，✅必填）：乘机人手机号
flight_cancel_order - 机票取消订单
取消已预订的机票订单。
参数：
▸ orderId（string，✅必填）：订单ID
train_search - 火车票搜索
按城市和日期搜索车次，支持6种排序方式。
参数：
▸ departureCity（string，✅必填）：出发城市，如"上海"
▸ arrivalCity（string，✅必填）：到达城市，如"南京"
▸ departureDate（string，✅必填）：出发日期，如"2025-07-01"
▸ sortBy（string，选填）：排序方式，默认按时间
train_detail - 火车票车次详情
查看余票、价格，获取预订参数。
参数：
▸ trainNo（string，✅必填）：车次号（从train_search结果获取）
▸ departureDate（string，✅必填）：出发日期
train_book - 火车票预订
下单预订火车票。
参数：
▸ trainNo（string，✅必填）：车次号
▸ seatType（string，✅必填）：座位类型
▸ passengerName（string，✅必填）：乘车人姓名
▸ passengerPhone（string，✅必填）：乘车人手机号
train_order_detail - 火车票订单详情
查看火车票订单详细信息。
参数：
▸ orderId（string，✅必填）：订单ID
train_cancel_order - 火车票取消订单
取消已预订的火车票订单。
参数：
▸ orderId（string，✅必填）：订单ID
ticket_query - 景点门票查询
按景点名搜索门票，返回价格、票种信息。
参数：
▸ scenicName（string，✅必填）：景点名称，如"故宫""迪士尼"
▸ cityName（string，选填）：城市名
ticket_create_order - 门票下单
预订景点门票。
参数：
▸ ticketId（string，✅必填）：票种ID（从ticket_query结果获取）
▸ visitDate（string，✅必填）：游览日期
▸ quantity（int，✅必填）：数量
📝 使用示例
▸ "帮我查7月1号上海到北京的机票" → flight_search
▸ "上海外滩附近酒店，7月1号入住3号退房" → hotel_search
▸ "明天上海到南京的高铁" → train_search
▸ "故宫门票多少钱" → ticket_query
▸ "帮我订这个酒店房间" → hotel_create_order
▸ "取消我的机票订单" → flight_cancel_order
