使用说明
RollingGo Flight MCP Server
RollingGo-Flight-MCP 是一个基于 MCP的机票服务，面向 AI Agent 和 MCP 客户端提供机场检索和航班查询能力。（更新日期：2026-04-24）。
在线端点
- MCP URL:
https://mcp.rollinggo.cn/mcp/flight - Transport:
streamable_http - 当前在线配置：无需在客户端侧配置 Bearer Token。如私有部署或业务渠道需要 API Key，请以实际环境配置为准。
工具列表
当前机票 MCP 对外文档保留 2 个可用工具：
searchAirports：根据城市名、机场名、机场代码等关键字搜索机场/城市信息searchFlights：查询指定日期、航线、人数、舱等的航班列表和价格
推荐调用流程
- 如果用户只提供自然语言城市名，先调用
searchAirports获取可用的cityCode或airportCode。 - 调用
searchFlights查询航班列表、航段信息和价格。 - 价格和库存都可能随供应商实时变化；展示给用户前或下单前建议重新查询。
1) searchAirports
根据关键字搜索机场、城市或相关交通节点信息。
输入参数
keyword(string，必填)：搜索关键字，例如城市名、机场名、机场代码。示例：杭州、Hangzhou、HGH、成都、CTU。
输出结构
{
"message": "机场搜索成功",
"airPortInformationList": [
{
"airportCode": "TFU",
"airportName": "Tianfu Airport",
"cityCode": "CTU",
"cityName": "Chengdu",
"countryCode": "CN",
"countryName": "China",
"timeZone": "+08:00"
}
]
}
说明：
airportCode可作为searchFlights.fromAirport/searchFlights.toAirport使用。cityCode可作为searchFlights.fromCity/searchFlights.toCity使用。- 搜索结果由供应商返回，可能包含城市相关交通节点，客户端应结合
cityCode、airportCode、countryCode做二次筛选。 - 当没有匹配结果时，
airPortInformationList可能为空数组。
2) searchFlights
查询指定日期、航线、乘客人数和舱等的航班方案。
输入参数
adultNumber(integer，必填)：成人数量。childNumber(integer，必填)：儿童数量，没有儿童时传0。cabinGrade(string，必填)：舱等偏好，支持：ECONOMY：经济舱PREMIUM_ECONOMY：超级经济舱BUSINESS：商务舱FIRST：头等舱
tripType(string，必填)：行程类型，支持：ONE_WAY：单程ROUND_TRIP：往返
fromDate(string，必填，格式：YYYY-MM-DD)：出发日期。retDate(string，往返必填，格式：YYYY-MM-DD)：返程日期。tripType=ROUND_TRIP时使用。fromCity(string，选填)：出发城市代码，与fromAirport二选一。示例：HGH。fromAirport(string，选填)：出发机场代码，与fromCity二选一。示例：HGH。toCity(string，选填)：到达城市代码，与toAirport二选一。示例：CTU。toAirport(string，选填)：到达机场代码，与toCity二选一。示例：TFU。
输出结构
{
"message": "航班搜索成功",
"flightInformationList": [
{
"routingId": "...",
"totalAdultPrice": 1813.0,
"totalChildPrice": 0.0,
"currency": "CNY",
"fromSmartValueScore": 95.0,
"validatingCarrier": "3U",
"fromSegments": [
{
"flightNumber": "3U8916",
"depTime": "2026-05-01T17:50:00",
"arrTime": "2026-05-01T21:00:00",
"depAirport": "HGH",
"arrAirport": "CTU",
"duration": "190",
"stopCities": ""
}
],
"retSegments": []
}
]
}
字段说明：
routingId：航线唯一 ID，标识本次搜索返回的航班方案。totalAdultPrice：成人总价，币种见currency。totalChildPrice：儿童总价，币种见currency。fromSmartValueScore：供应商返回的综合推荐分，分数越高通常代表价格、时间、直飞等综合表现越好。validatingCarrier：出票/承运相关航司代码。fromSegments：去程航段列表。直飞通常只有 1 段，中转会有多段。retSegments：返程航段列表。单程通常为空数组。duration：航段飞行时长，单位为分钟，当前返回为字符串。stopCities：经停城市；无经停时通常为空字符串。
说明：
- 价格和库存具有实时性，展示给用户前建议标注“以实际下单为准”。
- 同一城市可能包含多个机场，使用
fromAirport/toAirport可以限制到具体机场。 - 如果用户只说“成都”“上海”等城市，建议优先使用
fromCity/toCity让服务返回覆盖该城市多机场的结果。
使用示例
示例 1：搜索机场/城市代码
{
"keyword": "CTU"
}
示例 2：杭州到成都，五一单程，1 位成人，经济舱
{
"adultNumber": 1,
"childNumber": 0,
"cabinGrade": "ECONOMY",
"fromCity": "HGH",
"toCity": "CTU",
"fromDate": "2026-05-01",
"tripType": "ONE_WAY"
}
示例 3：杭州到成都往返，1 位成人，经济舱
{
"adultNumber": 1,
"childNumber": 0,
"cabinGrade": "ECONOMY",
"fromCity": "HGH",
"toCity": "CTU",
"fromDate": "2026-05-01",
"retDate": "2026-05-05",
"tripType": "ROUND_TRIP"
}
MCP 客户端配置示例
不同 MCP 客户端字段名可能略有差异，核心是配置 streamable_http 类型和线上 MCP URL。
{
"mcpServers": {
"RollingGo-Flight-MCP": {
"url": "https://mcp.rollinggo.cn/mcp/flight",
"type": "streamable_http"
}
}
}
如果你的 MCP 客户端要求显式 headers，可按业务环境补充：
{
"mcpServers": {
"RollingGo-Flight-MCP": {
"url": "https://mcp.rollinggo.cn/mcp/flight",
"type": "streamable_http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
接入建议
- LLM 参数抽取时，先判断用户要“单程”还是“往返”；往返必须补充
retDate。 - 用户只提供中文城市名时，可先用
searchAirports，但如果已经知道 IATA 城市代码，可以直接调用searchFlights。 - 国内城市多机场场景下，城市代码适合泛查，机场代码适合精确筛选。
- 展示航班时建议至少显示航班号、起降时间、出发/到达机场、总价、币种、是否中转。
相关链接
- GitHub 仓库：https://github.com/RollingGo-AI/rollinggo-readme
- API Key 申请：https://rollinggo.store/apply
- MCP 标准：https://modelcontextprotocol.io/
