MCP 实战全记录：从零配置高德/飞友服务，到让 AI 自动生成旅行报告
课程主线：这节课的核心目标非常明确——我们要搭建一个旅行报告生成助手。它需要整合四个信息模块：客户端（Cursor + Node.js）、地图服务端（高德）、航班服务端（飞友），最终通过 AI Agent 对话生成完整的 Web 版旅行报告。
一、架构准备：这四个信息模块缺一不可
在进入配置之前，老师先带我们回顾了整个实战的前置架构。要完成整套系统，必须准备好以下四个模块：
- 客户端环境：Cursor作为 AI 前端，通过 MCP 能力访问后端服务；Node.js为 MCP 提供通道能力支持。
- 地图服务端：高德地图作为 MCP Server，提供搜索、定位、路线规划等 LBS 能力。
- 航班服务端：飞友开放平台（非常准）提供航班查询能力，例如查询西安飞北京、北京飞西安的航班信息。
- 配置目标：将高德和飞友的 MCP 信息配置到 Cursor 中，通过与 AI Agent 聊天，让它为我们生成旅行报告。
小知识点：老师特别提示，国内主流地图厂商包括高德、百度、腾讯，且百度也提供 MCP 服务，感兴趣的同学可以课后自行探索。
二、高德地图 MCP 接入：这是本节课的第一个重点
高德地图的配置是本次课程占用时间最长、步骤最细的环节，老师手把手演示了从注册到验证的完整链路。
2.1 开发者账号与应用创建
首先访问高德开放平台（lbs.amap.com）。这里有两个入口值得注意：
- amap.com：直接提供地图页面供你点击使用。
- lbs.amap.com：开放平台，面向开发者和企业，通过 API 调用高德能力。接入 MCP 必须使用开放平台。
📌作者创建时用的链接~
具体步骤与课堂例子：
- 注册认证：注册账号后，建议认证为“个人开发者”。老师强调：个人开发者比免费账号的API 调用配额更高，例如搜索类接口会计算额度，认证后额度会有明显提升。
- 创建应用：在控制台创建新应用，课上老师命名了一个非常具体的例子——“mcpso5”（我起的名字是“位置服务”），应用场景选择“其他”。
- 获取 Key：在应用下创建 Key，这里有两个关键细节：
- Key 类型选择“Web 服务”。
- 名称可自定义，课上例子为“MCP Beta t5”。
- IP 白名单：老师提到“不配置 IP 白名单主要是进行保护”，但对于学习场景可以先不限制。如果真实业务上线，建议配置 IP 白名单防止 Key 泄露，因为高德是按次收费（或额度计费）的，泄露可能导致被恶意盗用。
- 最后点击同意服务协议，生成 Key 并妥善保存。
零碎知识点：老师提到，进入控制台的方式除了在 lbs.amap.com 点击入口，也可以直接访问console.amap.com。
2.2 通信方式选择：为什么选 SSE？
高德提供了两种 MCP 接入方式：
流式 HTTP（SSE）：直接通过 HTTP 流进行通信，配置简单，不依赖额外命令。
NPX 命令：通过
npx命令提供通道与高德 MCP Server 通信。
本课选择 SSE 方式，原因是配置更直接，适合快速接入。
2.3 Trea 中的 MCP 配置实操
这是最容易踩坑的部分，老师分了三步走：
Step 1：初始化工作空间
新建目录（作者起名为MCP实战体验），在 Trea 中打开该文件夹作为工作空间。
Step 2：配置 MCP Server
进入 Trea 的首选项 → 设置 → MCP，点击“添加”→“手动配置”。将高德提供的流式 HTTP 连接字符串（包含刚才申请的 Key）直接拷贝粘贴进去。
异常处理（重要）：如果系统提示“MCP Server 名称已经存在”，说明之前可能配置过。此时不要重复添加，而是选择编辑现有配置，将新信息覆盖写入即可。
Step 3：启用与刷新
配置完成后需要：
- 点击启用；
- 执行刷新动作。
刷新后，系统会识别到高德地图提供的多项能力，如骑行规划、驾车规划等。此时界面上可能会出现一个“API 函数名过长”的告警，老师明确指出：这个告警影响不大，可以忽略，不影响正常使用。
2.4 最关键的一步：在智能体中挂载能力
很多同学容易误以为配置完 MCP Server 就万事大吉了。老师特别强调：
“贴着 MCP 后我们仍然无法使用，需要将智能体的 MCP 加入。”
必须进入智能体（Agent）设置界面，勾选高德地图相关的 MCP 能力选项，然后保存并立即使用。没有这个步骤，AI Agent 是无法调用地图接口的。
2.5 功能验证：课堂现场测试
配置完成后，老师当场进行了测试：
- 测试指令：“从西安北站去西安站怎么走？”
- 执行过程：Agent 自动查看可用的 MCP Server，识别到高德地图服务，然后自动调用坐标查询及路径规划接口。
- 测试结果：成功返回推荐路线，证明高德 MCP 服务连接正常且可用。
三、飞友开放平台接入：SSE 方式打通航班数据
完成高德地图后，课程进入了第二个服务端——飞友开放平台（航班数据）的配置。
3.1 平台服务能力概览
非 AI 开放平台提供了两类 MCP 服务：
- 航旅信息 MCP：支持机票价格实时追踪、航班信息查询。
- 中长距离出行 MCP：覆盖更广泛的出行场景。
核心能力包括：
- 航班实时动态查询：获取航班当前运行状态。
- 飞机实时定位查询：只需要一个航班编号，即可获取飞机的经纬度、高度及速度。
- 机场天气查询：提供机场未来的整体天气状况。
3.2 账号注册与额度
📌飞友链接
- 完成注册并登录，成为平台开发者。
- 重要福利：新用户注册后默认赠送 50 元测试额度，足够支撑初期的功能测试。老师特别提到这一点，让大家放心调试。
3.3 密钥申请与 NPX 配置
登录后创建新的 API 应用，课上老师命名为“MCP test”，系统生成对应密钥，需拷贝保存。
回到官方接入文档，找到NPX 方式的接入指南。
找到“监测串”（即连接字符串/Connection String），将之前申请的密钥替换进该字符串模板中。
进入 Trea 设置（文件 → 首选项 → 设置），找到 MCP 配置，手动添加该连接串。
同样，如果提示“MCP 已存在”，选择覆盖原有配置。
点击启用，界面显示对勾标志，表明已成功获取 MCP 能力（这些能力以函数或工具的形式呈现）。
最后一步：在相关管理界面（如 Agent 设置）勾选启用选项并保存，完成最终激活。
四、Trea 平台演示：当 MCP 生态汇聚成一份旅行报告
课程的后半段，老师在Trea 平台，给我们展示了当高德+飞友能力整合后，AI 能够产生的惊人效果——无代码生成一份完整的 Web 版旅行报告。
4.1 业务场景与执行过程
用户诉求：从西安飞往北京旅游三天，生成具体旅游计划、景点路线，使用高德地图生成具体路线信息，并查询航班信息给出合理建议，最终输出 Web 版报告。
耗时：新建工作空间并提交诉求后，系统经过约2 分钟的处理，自动完成报告生成。
4.2 后台调用逻辑拆解
老师展开系统的“思考过程”，让我们看到了底层的 MCP 调用链路：
- 航班查询：系统调用了2 次飞友开放平台，获取西安到北京的航班信息。
- 景点坐标获取：系统调用了10 次坐标查询接口（MAC/工具），获取北京主要景点的坐标。例如输入地址“天安门广场”，返回信息中包含
location（即经纬度），用于计算景点间距离。
4.3 生成的报告内容（课堂具体例子）
老师打开生成的 Web 报告，展示了以下内容：
航班建议：
- 去程：建议乘坐MU2131航班，06:30 起飞，08:30 到达。
- 返程：建议乘坐HU7137航班，06:40 起飞，09:10 到达。
行程导航（第一天）：
- 从北京大兴国际机场到天安门广场。
- 包含步行、机场快线及地铁换乘的具体路线与时间。
- 点击“高德导航”后，可以在地图上直接看到起点、终点及详细走向的可视化路径。
综合建议：
- 涵盖第二天、第三天的行程安排。
- 提供清晰的费用预估。
- 包含出行注意事项：穿衣建议、美食推荐、交通攻略总结。
这就是 MCP 整合后的最终成果：AI 不再需要你在各个 App 间跳转，它自己调用了高德和飞友的数据，在两分钟内帮你生成了一份可直接浏览的旅行方案。
五、MCP 广场与生态：远不止地图和航班
通过 Modus 的MCP 广场，老师向我们展示了 MCP 协议的庞大生态。借助内置的 MCP 客户端，无需编写复杂代码即可连接各种外部服务。
课堂提到的服务项目包括：
- 生活服务：如麦当劳点餐。
- 浏览器操纵：Chrome 开发者工具，可通过 MCP 操纵浏览器完成任务。
- 办公辅助：ChatPPT（生成 PPT）、查询火车票等。
5.1 服务模式：Hosted vs Local
MCP 广场支持两种服务模式，这是理解 MCP 架构的关键：
- Hosted MCP：服务端部署在远端服务器上。例如高德地图（Amap），由阿里官方提供，属于 Hosted 模式。用户请求先发送至 Modus，再转发至高德地图服务器。
- Local MCP：服务端部署在用户本机上（如一些本地文件处理工具）。
课上举的具体例子：配置高德时，请求域名发生了变化，请求的是 Google/Modus，再由 Modus 将信息转给高德地图。
5.2 计费机制
使用 MCP 服务会消耗平台的Book（积分）或Token。课上老师提到：
- 平台会显示具体的积分消耗情况。
- 不同大模型调用的计费模式并不完全相同，使用时要留意成本。
六、避坑指南与细碎知识点汇总
为了不遗漏任何课堂细节，特别整理老师反复提及或随口一提但极有价值的知识点：
| 知识点 | 说明 |
|---|---|
| 个人开发者认证 | 高德平台建议认证个人开发者，API 配额比免费账号更高。 |
| IP 白名单 | 安全防御措施，可防止 Key 泄露后被恶意调用产生计费。 |
| SSE vs NPX | 两种接入通道，SSE 更直接，NPX 依赖本地 Node 命令通道。 |
| 配置冲突处理 | Trea 中提示“Server 名称已存在”时，选择编辑并覆盖，不要重复添加。 |
| API 函数名过长告警 | 启用高德后出现此告警属正常现象，不影响功能使用。 |
| Agent 必须打勾启用 | 仅配置 MCP Server 不够，必须在 Agent 设置中勾选对应能力才能调用。 |
| 飞友新用户 50 元额度 | 足够前期测试，不用担心立即收费。 |
| 飞友 NPX 接入 | 在接入文档中找到连接字符串（监测串），替换自己的 Key 后填入 Trea。 |
| 坐标查询返回 location | 包含经纬度，用于 AI 计算景点间距离，进而规划合理行程。 |
| Trea 2 分钟生成报告 | 实际耗时约两分钟，期间 AI 在自主调用多个 MCP 接口。 |
| Hosted / Local 区别 | 官方服务一般在远端（Hosted），本机工具为 Local，后续架构课会深入讲。 |
七、总结与下节预告
到这节课结束，我们已经完成了以下基础环境的搭建：
- ✅ 高德地图 MCP 服务接入并验证（西安北站 → 西安站路线测试成功）
- ✅ 飞友开放平台 MCP 服务接入（NPX 方式，拥有 50 元测试额度）
- ✅ 通过 Trea 平台体验了无代码调用 MCP 生态生成旅行报告的完整流程
老师最后预告：下一节将深入讲解 MCP 的核心架构，重点剖析客户端与服务端的交互原理、数据流转机制，以及 Hosted 和 Local MCP 在技术实现上的深层差异。
如果你也在跟进 MCP 实战，建议按照本文的“四个信息模块”思路，先把高德和飞友的 Key 申请好，在 Trea 里把 SSE/NPX 连接串配通，亲自对 Agent 说一句“从西安北站去西安站怎么走”——当你看到 AI 真的调用了地图接口并返回路线时，你会直观感受到：MCP 不是概念，而是已经可用的生产力。
