MCP 教程：使用高德地图 MCP Server 规划行程

🗺️ 【教程】使用高德地图 MCP Server 规划行程

📋 教程概述

本文将详细介绍如何在 Trae IDE 中使用高德地图的 MCP Server（amap-maps）来规划旅行行程。通过该最佳实践，你可以在 Trae IDE 中创建一个功能完备的 "行程规划助手"。根据你的目的地，它可以使用高德地图的 MCP Server 高效地访问地图数据、获取路线信息、查询周边景点等，让你的出行规划过程更加便捷和智能。

✨ 效果展示

以下示例中，使用配置了 MCP Server（amap-maps）的 "行程规划助手" 制作了一个成都三日游行程规划：

行程规划示例：成都三日游

• 第一天：春熙路 → 宽窄巷子 → 锦里古街 → 武侯祠 → 九眼桥夜景
• 第二天：大熊猫繁育研究基地 → 东郊记忆 → 太古里 → 成都金融城双子塔
• 第三天：都江堰景区 → 青城山 → 成都西站

智能助手不仅提供了详细的景点信息，还计算了各景点之间的距离和交通时间，推荐了周边的特色餐厅和酒店，让整个行程规划更加合理和高效。

🖥️ 演示环境

本教程中使用的系统环境如下：

• Trae IDE 版本：0.5.5
• macOS 版本：14.7
• Node.js 版本：20.19.1
• npx 版本：10.9.2

🔧 实现步骤

1️⃣ 安装 Trae IDE

Trae IDE 是一款与 AI 深度集成的开发工具，提供智能问答、代码自动补全以及基于 Agent 的 AI 自动编程能力。使用 Trae 开发项目时，你可以与 AI 灵活协作，提升开发效率。

具体步骤：

1. 访问 Trae CN 官网
2. 点击 "下载" 按钮，选择适合你操作系统的版本
3. 下载完成后，按照安装向导的提示完成安装
4. 启动 Trae IDE，创建一个新的工作区

2️⃣ 配置 MCP Server 的运行环境

为确保正常启动 MCP Server，你需要安装以下依赖：

依赖安装步骤：

1. 安装 Node.js

   • 访问 Node.js 官网，下载并安装 Node.js v20+ 版本
   • 安装完成后，在终端中运行 node -v 验证安装是否成功

2. 验证 npx

   • npx 通常随 Node.js 一起安装
   • 在终端中运行 npx -v 验证是否可用

3️⃣ 成为高德地图开发者并创建 Key

要使用高德地图的 MCP Server，你需要先成为高德地图开发者并获取 API Key。

详细步骤：

1. 开发者账号注册

   • 访问 高德地图开放平台
   • 点击右上角的 "注册" 按钮，创建开发者账号
   • 完成个人/企业实名认证（需要使用支付宝扫码验证）

2. 创建应用

   • 登录后，进入 "控制台"
   • 点击 "创建新应用"，填写应用名称和应用类型
   • 选择 "Web服务" 类型，填写应用描述信息

3. 获取 API Key

   • 在应用管理页面，点击 "添加 Key"
   • 选择服务类型为 "高德MCP Server"
   • 阅读并同意服务条款
   • 点击 "提交"，系统会生成一个 API Key
   • 保存生成的 Web 服务密钥（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

4. 服务能力验证

   • 打开 Postman 或其他 API 测试工具

   • 测试高德地图的基础 API，例如地理编码 API：

     https://restapi.amap.com/v3/geocode/geo?key=你的API Key&address=北京市朝阳区

   • 如果返回正常的 JSON 数据，说明 API Key 已成功激活

4️⃣ 在 Trae IDE 中接入高德地图 MCP Server

现在，让我们在 Trae IDE 中配置并接入高德地图 MCP Server。

具体操作：

1. 创建项目

   • 打开 Trae IDE
   • 点击 "File" → "New Project"
   • 选择 "Empty Project"，输入项目名称（例如 "TravelPlanner"）
   • 点击 "Create" 创建项目

2. 配置 MCP Server

   • 在 AI 对话框的右上角，点击 设置 图标，然后在菜单中选择 MCP

   • 界面上显示 MCP 页签

   • 在 MCP 页签中，点击 + 添加 MCP Servers 按钮。若你已添加过 MCP Server，则点击右侧区域的 + 添加 按钮

   • 你已进入 MCP Server 市场

   • 点击 手动配置

   • 界面上显示 手动配置 弹窗

   • 在输入框中粘贴以下配置内容。AMAP_MAPS_API_KEY 部分需要填入之前在高德开放平台上创建的 Key：

     {
       "mcpServers": {
         "amap-maps": {
           "command": "npx",
           "args": ["-y", "@amap/amap-maps-mcp-server"],
           "env": {
             "AMAP_MAPS_API_KEY": "你在高德官网上申请的 key"
           }
         }
       }
     }

   • 点击底部的 确认 按钮

3. 验证 MCP Server 状态

   • 高德地图 MCP Server（amap-maps）已被接入 Trae IDE，并已被自动添加至内置智能体 - Builder with MCP
   • 配置完成后，MCP Server 状态应显示为 "Connected"
   • 你可以在 "MCP Explorer" 中查看可用的 API 接口

5️⃣ 配置智能体

接下来，我们需要配置一个智能体，使其能够使用高德地图的 MCP Server 来规划行程。智能体（Agent）是你面向不同开发场景的编程助手，通过灵活配置提示词和工具集，可以更高效地完成复杂任务。

详细配置：

1. 打开智能体配置页面

   • 在 AI 对话框的右上角，点击 设置 图标
   • 在菜单中选择 智能体
   • 界面上显示 智能体 页签

2. 创建新智能体

   • 点击右侧区域的 + 创建智能体 按钮
   • 智能体配置面板已打开

3. 配置智能体

   1. (可选) 上传智能体的头像

   2. 输入智能体的名称（例如：行程规划助手）

   3. 配置智能体的提示词。你可以使用以下参考提示词：

      你是一个经验丰富的旅行大师，具备成熟的行程规划能力。根据用户提供的目的地，你需要为用户制作详细的行程规划。具体要求如下：
      
      ## 设计要点
      - 网格布局，分区清晰
      - 打印友好：高对比度、合适字体、避免深背景
      - 使用合适的图标区分活动类型（景点/餐饮/交通等）
      - 融入简约现代风格和专业旅行指南元素
      - 制作网页地图，自定义绘制旅游路线和位置
      - 网页使用简约美观页面风格，景区图片以卡片展示
      - 行程规划结果在高德地图 app 展示，并集成到 h5 页面中
      
      ## 必备内容
      - 行程标题（目的地、日期、天气）
      - 每日概览（带图标的活动摘要）
      - 详细时间表（时间/地点/活动/备注）
      - 交通信息（地图/路线/时间/方式）
      - 食宿信息（地址/时间/推荐）
      - 实用信息（紧急电话/注意事项）

   4. 配置工具

      • 在 工具-MCP 部分，仅勾选 amap-maps
      • 在 工具-内置 部分，勾选以下四个工具：
        • 文件系统（File System）：对文件进行增删改查
        • 终端（Terminal）：在终端运行命令，并获取命令的运行状态和结果
        • 联网搜索（Web Search）：搜索和用户任务相关的网页内容
        • 预览（Preview）：在生成可预览的前端结果后提供预览入口

4. 完成创建

   • 点击底部的 创建 按钮
   • 智能体创建成功
   • 点击 立即使用 按钮，开启与智能体的对话

6️⃣ 使用指令生成行程计划

现在，让我们测试智能体，使用它来生成一个详细的行程计划。

使用示例：

1. 发送行程规划请求

   • 在 Trae IDE 的聊天界面中，向智能体发送以下消息：

     帮我规划一个成都三日游的行程，包括主要景点、交通路线和推荐餐厅。我从重庆出发，第一天想游览市区核心景点，第二天想去大熊猫基地和城市文化地标，第三天想体验都江堰和青城山的自然风光。

2. 智能体处理过程

   • 智能体接收到请求后，会分析是否需要调用高德地图服务
   • 检测到包含地图相关关键词后，会调用 MCP Server 获取以下信息：
     • 重庆到成都的交通路线和时间
     • 成都市区的主要景点
     • 大熊猫基地和都江堰、青城山的位置及之间的距离
     • 各景点周边的推荐餐厅

3. 生成详细行程规划

   • 智能体整合获取的信息，生成详细的行程规划方案

   • 输出结果示例：

     ## 🗺️ 成都三日游行程规划
     
     ### 第一天：市区核心景点游
     **上午**：从重庆乘坐高铁到成都东站（约2小时）
     **中午**：春熙路商圈 - 宽窄巷子
     **推荐餐厅**：龙抄手（春熙路店）
     **下午**：锦里古街 - 武侯祠
     **晚上**：九眼桥夜景（酒吧街）
     **推荐住宿**：成都太古里附近酒店
     
     ### 第二天：大熊猫与城市文化
     **上午**：大熊猫繁育研究基地（建议早上去，熊猫活动活跃）
     **推荐餐厅**：陈麻婆豆腐（总店）
     **下午**：东郊记忆 - 太古里
     **晚上**：成都金融城双子塔（夜景）
     
     ### 第三天：都江堰与青城山
     **上午**：都江堰景区（世界文化遗产）
     **推荐餐厅**：都江堰南桥附近餐厅
     **下午**：青城山（道教名山，世界文化遗产）
     **晚上**：返回成都市区，准备返程
     
     **交通建议**：
     - 市内交通可选择地铁和出租车，成都地铁网络发达
     - 去大熊猫基地可乘坐地铁3号线转熊猫专线
     - 去都江堰和青城山可乘坐高铁，从成都犀浦站出发，约30分钟到达
     - 景区内可乘坐观光车，节省体力

🚀 MCP Server 2.0 特点

高德地图推出的 MCP Server 2.0，通过 SSE(Server-Sent Events) 协议，将以下能力无缝集成到大模型中：

核心功能

• 🗺️ 路径规划：提供驾车、公交、步行、骑行等多种出行方式的路线规划，包含实时路况信息
• ☁️ 天气查询：获取目的地的实时天气和未来天气预报
• 🏪 周边搜索：查询指定位置附近的餐厅、酒店、景点、加油站等兴趣点
• 📍 地点详情：获取地点的详细信息，包括地址、电话、营业时间等
• 🚗 交通信息：提供城市交通状况、拥堵路段等信息
• ⏱️ 实时路况：获取道路的实时通行状况和预计通行时间

技术优势

1. 实时数据：通过 SSE 协议实现实时数据传输，确保信息的及时性
2. 低延迟：优化的 API 设计，减少请求响应时间
3. 高可靠性：高德地图的基础设施保障服务稳定性
4. 易于集成：提供简洁的 API 接口，方便与大模型集成
5. 功能丰富：涵盖出行相关的多种服务，满足不同场景需求

这彻底打破了数据孤岛，让大模型能够实时获取和处理地图相关信息，为用户提供更加准确和实用的行程规划建议。

💡 最佳实践建议

要充分发挥高德地图 MCP Server 的能力，以下是一些最佳实践建议：

1. API Key 管理

   • 妥善保管你的高德地图 API Key，避免在代码中硬编码
   • 考虑使用环境变量或配置文件来存储 API Key
   • 定期检查 API Key 的使用情况，避免泄露或滥用
   • 对于生产环境，建议设置 API Key 的访问限制

2. 请求频率管理

   • 注意高德地图 API 的请求频率限制（通常为每秒 200 次）
   • 实现请求缓存机制，避免重复请求相同的数据
   • 对于批量请求，考虑使用异步处理方式
   • 监控 API 使用量，避免超过配额导致服务中断

3. 错误处理与容错

   • 添加适当的错误处理机制，确保服务稳定性
   • 实现请求重试逻辑，处理网络临时故障
   • 为关键功能提供降级方案，当 MCP Server 不可用时仍能提供基本服务
   • 记录详细的错误日志，便于问题排查

4. 用户体验优化

   • 优化智能体的回复格式，使行程规划更加清晰易读
   • 添加适当的加载提示，提升用户体验
   • 考虑使用可视化方式展示路线和景点信息
   • 提供行程分享功能，方便用户与他人共享

5. 个性化服务

   • 根据用户的偏好和需求，定制行程规划建议
   • 考虑用户的出行方式、预算、兴趣等因素
   • 提供多种行程方案供用户选择
   • 记忆用户的历史偏好，提供更加个性化的建议

6. 性能优化

   • 减少不必要的 API 调用，优化请求参数
   • 实现数据预加载，提升响应速度
   • 考虑使用本地存储缓存常用数据
   • 对于复杂的行程规划，考虑使用后台异步处理

🔍 故障排除

如果在使用过程中遇到问题，可以尝试以下解决方案：

常见问题及解决方案

1. API Key 错误

   • 检查 API Key 是否正确，是否包含多余的空格或字符
   • 确认 API Key 是否已启用 MCP Server 服务
   • 检查 API Key 是否过期（高德地图 API Key 通常有使用期限）
   • 验证 API Key 的权限范围是否包含所需的服务

2. 网络连接问题

   • 确保你的网络连接正常，能够访问互联网
   • 检查防火墙设置，确保允许访问高德地图 API
   • 尝试使用不同的网络环境测试
   • 验证 DNS 设置是否正确，能够解析高德地图的域名

3. 权限问题

   • 检查应用的权限设置，确保已授权访问所需的地图服务
   • 确认开发者账号已完成实名认证
   • 检查是否已同意相关服务条款
   • 验证应用类型是否与使用的 API 服务匹配

4. 版本兼容性问题

   • 确保使用的 Trae IDE 版本支持 MCP Server 功能（建议使用最新版本）
   • 检查 Node.js 版本是否符合要求（推荐 v20+）
   • 验证 MCP Server 依赖包的版本是否兼容
   • 确保高德地图开放平台的 API 版本与你的代码兼容

5. 依赖缺失问题

   • 高德地图 MCP Server 不需要通过 npm 安装，依赖缺失问题主要针对 Trae IDE 本身
   • 确保 Trae IDE 已更新到最新版本
   • 检查 Trae IDE 的 MCP 插件是否已正确安装
   • 尝试重启 Trae IDE 以解决插件加载问题

6. 响应数据异常

   • 检查请求参数是否正确，格式是否符合 API 要求
   • 验证返回的 JSON 数据结构是否与预期一致
   • 检查是否有错误码返回，参考高德地图 API 文档的错误码说明
   • 尝试简化请求，逐步添加参数进行测试

7. 服务限流问题

   • 检查是否超过了高德地图 API 的请求频率限制
   • 实现请求间隔控制，避免短时间内发送过多请求
   • 考虑使用高德地图的批量查询 API，减少请求次数
   • 监控 API 使用量，合理规划请求策略

📚 相关资源

以下是一些与高德地图 MCP Server 和行程规划相关的资源：

官方文档

• Trae IDE 官网 - 提供 Trae IDE 的下载、文档和教程
• 高德地图开放平台 - 高德地图开发者平台，提供 API 文档和服务
• MCP 官方文档 - 高德地图 MCP Server 的详细文档
• 高德地图 API 文档 - 高德地图 JavaScript API 文档

教程与示例

• w3cschool 教程 - 详细的 Trae + 高德地图 MCP 教程
• Trae 官方示例库 - 包含各种 Trae 使用示例
• 高德地图示例中心 - 提供各种高德地图 API 的使用示例

社区资源

• Trae 社区论坛 - Trae 用户交流社区
• 高德地图开发者论坛 - 高德地图开发者交流平台
• GitHub Issues - 高德地图示例代码和问题讨论

工具与辅助资源

• Postman - API 测试工具，用于测试高德地图 API
• JSON Viewer - 在线 JSON 格式化和查看工具
• MapBox - 备用地图服务，可作为高德地图的补充
• Weather API - 天气数据 API，可与行程规划结合使用

🎯 总结

通过本教程，你已经详细了解了如何在 Trae IDE 中使用高德地图的 MCP Server 来创建一个智能的行程规划助手。从环境搭建、API Key 获取到智能体配置，我们覆盖了完整的实现流程。

实现的功能

• ✅ 成功集成高德地图 MCP Server
• ✅ 配置智能行程规划助手
• ✅ 实现路线规划和景点查询
• ✅ 提供餐厅和酒店推荐
• ✅ 生成详细的多日行程计划

应用价值

这一工具不仅可以帮助你规划个人旅行，还可以作为一个实用的应用案例，展示如何将大模型与专业服务相结合，创造出更有价值的应用。通过 MCP Server，我们打破了大模型的数据孤岛问题，让 AI 能够获取实时的地图和位置信息，提供更加准确和实用的建议。

扩展可能性

你可以进一步扩展这个行程规划助手的功能：

1. 多语言支持：添加多语言界面，服务国际用户
2. 移动端适配：开发移动端应用，方便用户随时随地使用
3. 社交功能：添加行程分享和协作规划功能
4. 智能推荐：基于用户历史偏好，提供更加个性化的推荐
5. 多模式交通：整合公共交通、网约车等多种交通方式

现在，你可以尝试创建自己的行程规划助手，根据个人需求进行定制，让出行变得更加轻松愉快！祝你旅途愉快！