# 全球机票查询-RollingGo
## 基本信息
- Slug: `yorklu-rollinggo_flight`
- Source: modelscope
- Publisher: yorklu/RollingGo_Flight
- Categories: search / developer-tools / calendar-management
- Hosted: Yes
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/yorklu/RollingGo_Flight
## 简介
RollingGo-Flight-MCP 是一款 MCP 原生的全球机票服务插件，完美适配 Claude 、Cursor、Codex等AI Agent 和主流 MCP 客户端。 基于道旅官方供应链，内置机场智能识别与航班多维检索两大核心工具，整合 RollingGo 全球 500 + 合作航司、覆盖 200 + 国家和地区的千万级航线资源，支持实时价格查询、舱等筛选、行程匹配等专业功能，具备企业级高并发稳定性与 7×24 小时服务保障，帮助企业和个人开发者零成本构建具备机票交易能力的 AI 应用。
## 安装提示

```bash
也可以通过命令行直接添加： ```bash claude mcp add \ --transport http \ --header "Authorization: Bearer YOUR_API_KEY" \ RollingGo-Hotel \ https://mcp.rollinggo.cn/mcp claude mcp add \ --transport http \ --header "Authorization: Bearer YOUR_API_KEY" \ RollingGo-Flight \ https://mcp.rollinggo.cn/mcp/flight
```

## MCP Server 详情

# RollingGo Flight MCP全球机票MCP服务
- **面向**：第三方开发者、AI Agent 构建者、MCP 客户端用户
- **目标**：5 分钟内完成第一次 MCP Tool 调用，拿到航班查询结果
- **全球机票预定**：提供查询、比价、预订全流程能力，企业个人均可免费一键使用。

## 核心优势
- **官方出品，全球覆盖**：500+ 合作航司，覆盖全球 200+ 国家和地区、1000+ 全球目的地
- **航线丰富**：千万级航线组合，满足多样化出行需求，支持直飞、中转等多种行程类型
- **价格优势**：整合全球优质机票资源，提供更具竞争力的实时价格
- **服务保障**：专业团队支持，7×24 小时全天候客户服务响应
- **直连航司供应链、远期早鸟票查询、自动价格预警**


## 适用人群
- 有机票监控、酒店查询、酒店比价需求的个人用户
- 正在开发 AI Agent 的团队或个人开发者
- 想在 MCP Client 中接入机票预订能力的开发者
- 正在构建旅行规划、差旅管理、OTA、生活服务类智能体的开发者
- 希望验证 AI Agent 商业交易闭环的产品团队

## 应用场景
- **通用 AI Agent**：让你的大模型 Agent 直接拥有原生机票预订能力，用户在自然对话中即可完成从需求理解、智能推荐、比价筛选到订单创建的全流程
- **AI 旅行助手**：根据用户出发地、目的地、出行日期、预算和个性化偏好精准推荐航班，支持多维度需求匹配
- **行程规划工具**：把机票搜索和预订能力无缝嵌入对话式行程规划流程，实现 "规划即预订" 的一体化体验
- **MCP / Agent Demo**：快速验证 "AI Agent 直接完成机票交易" 的产品能力，打造可演示的完整闭环

## 核心功能
- 支持城市名称、机场代码、航空公司名称、航班号等多种关键字精准搜索机场和航班信息
- 提供灵活的出发/返程日期设置、舱等选择（经济舱/超级经济舱/商务舱/头等舱）、乘客人数配置、直飞/中转筛选、航空公司偏好等专业筛选功能
- 基于用户个人偏好提供个性化推荐，生成高性价比、最快到达、最少中转、热门航司等多维度专业榜单
- 全程自然语言交互，智能完成从地点解析、航班查询、比价筛选、个性化推荐到订单生成的完整闭环
- 价格和库存实时同步供应商数据，确保查询结果准确可订

## 你可以让 Agent 完成以下机票相关任务
- 根据出发地、目的地、出行日期和乘客人数搜索航班
- 查询航班价格、舱位信息和实时库存
- 判断航班或舱位是否可订
- 构建航班推荐、比价、行程规划等 AI 工作流
- 将机票能力接入到 Claude、Cursor、Cherry Studio、ChatGPT MCP Client 或其他支持 MCP 协议的客户端中

- ⚠️如果你使用 ClawHub/扣子/Qclaw等Agent 平台，请使用我们的[Rollinggo全能订机票酒店Skill](https://modelscope.cn/collections/yorklu/RollingGo-quannengdingjiudianjipiao-Skill)。请参考[RollingGo Skill 配置指南](https://rollinggo.store/docs/skill-docs/skill-config).
---

## 🚀快速开始
> 💡 总结来说，你只需要做两件事：申请API Key+ 在AI助手中一键配置，**无需编写代码**，就能让任何支持MCP的AI助手具备酒店搜索能力，5 分钟内完成第一次 MCP Tool 调用，

### 第一步：获取API密钥

1. [点击进入申请地址](https://mcp.agentichotel.cn/apply)
2. 填写基本信息，1-3 分钟内自动审核通过，收到邮件包含：
API Key
伙伴中心账号（登录名 + 初始密码），登录后可配置加价比例、查看订单、查询收益
3. ⚠️ 注意查收邮件，如未收到请检查垃圾邮箱
4. 为了感谢首批愿意尝鲜、快速行动的开发者，我们特别推出限时福利：**所有收到 API Key 后 3 天内完成第一次工具调用，即可自动解锁永久免费无限制调用额度。**
我们希望优先支持真正有需求、有执行力的开发者，让大家零成本体验完整的机票 MCP 能力。

> 邮件中同时包含酒店MCP端点和机票MCP端点，一个Key即可接入，你可选择性使用。我们同时在魔搭上架了[RollingGo Hotel MCP](https://modelscope.cn/mcp/servers/yorklu/AI_Go_Hotel_MCP)产品介绍。

**为什么需要填写信息申请 KEY**？

酒店价格、库存和订单能力涉及真实交易链路，因此我们需要为每个开发者开通**免费专属的独立 KEY**。申请 KEY 时仅需填写少量信息，这样做主要是为了：
- 为你免费开通合适的接口权限
- 在接入过程中提供技术支持
- 判断你的使用场景，减少无效配置成本
- 保护接口稳定性，避免恶意调用或异常流量
- 在测试订单、价格查询、库存校验等问题上能及时联系到你

我们只会将这些信息用于 KEY 开通、接入支持和服务安全，不会对外共享，也不会用于无关用途。若你只是想先体验 MCP，也可以说明你的测试目标，我们会尽量提供轻量的测试支持。

### 第二步：在AI助手中配置

> 推荐 Claude CLI、Codex、Cursor 三个客户端。其他支持 MCP 的客户端（如 Kiro、豆包等）配置方式类似。

### Claude CLI

在项目根目录创建 `.mcp.json`：

```json
{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

也可以通过命令行直接添加：

```bash
claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  RollingGo-Hotel \
  https://mcp.rollinggo.cn/mcp

claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  RollingGo-Flight \
  https://mcp.rollinggo.cn/mcp/flight
```

### Codex

配置文件位置：项目根目录 `.codex/config.json` 或全局 `~/.codex/config.json`

```json
{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Cursor

配置文件位置：项目根目录 `.cursor/mcp.json` 或全局 `~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

> 将 `YOUR_API_KEY` 替换为你收到的实际 API Key。酒店和机票使用相同的认证方式，区别仅在于 URL（`/mcp` vs `/mcp/flight`）。

### cURL 直接测试

> **注意**：cURL 必须带 `-H "Accept: application/json, text/event-stream"` 头，否则服务端返回 400。

```bash
curl -X POST https://mcp.rollinggo.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "searchHotels",
      "arguments": {
        "originQuery": "上海外滩五星酒店",
        "place": "上海外滩",
        "placeType": "景点",
        "checkInParam": {
          "checkInDate": "2026-06-01",
          "stayNights": 2
        },
        "filterOptions": {
          "starRatings": [5.0]
        },
        "size": 3
      }
    },
    "id": 1
  }'
```

---

## 第四步：第一次 MCP 调用

配置完成后，对你的 AI 助手说：

> "帮我搜一下杭州到北京的机票"。AI 会自动调用Tool，返回机票列表。

### 机票查询示例（两步）

**Step 1**：搜索机场，获取城市代码

```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchAirports",
    "arguments": { "keyword": "杭州" }
  },
  "id": 1
}
```

**Step 2**：用城市代码查询航班

```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchFlights",
    "arguments": {
      "adultNumber": 1,
      "childNumber": 0,
      "cabinGrade": "ECONOMY",
      "tripType": "ONE_WAY",
      "fromCity": "HGH",
      "toCity": "CTU",
      "fromDate": "2026-06-01"
    }
  },
  "id": 1
}
```

---

## 第五步：查看结果，展示案例

### 机票查询结果（实测数据）

> 杭州→成都，单程，经济舱，共返回 **95 条航班**：

| 航班号 | 航线 | 时间 | 价格 |
|--------|------|------|------|
| CA1741 | 杭州萧山 → 成都天府 | 07:40 - 10:40 | ¥2,869 |
| CZ6198 | 杭州萧山 → 武汉 | 13:10 - 15:00 | ¥4,631 |
| CA3338 | 杭州萧山 → 深圳 | 12:55 - 15:15 | ¥5,341 |
---

## 附录

[mcp tool参考文档](https://rollinggo.store/docs/mcp-docs/mcp-tool-reference)

### 推荐调用流程
**机票查询**
```
1. 用户说"帮我查机票"
2. 调用 searchAirports → 获取城市代码
3. 调用 searchFlights → 返回…