摘要:哈喽大家好呀,「玩转 MCP」系列不知不觉已经到了第三弹,在之前的系列教程中我们分别向大家介绍了如何通过使用 MCP 将你的 Figma 设计稿转换为前端代码以及如何用 MCP 实现网页自动化测试,还没看过的小伙伴快去补课吧~
哈喽大家好呀,「玩转 MCP」系列不知不觉已经到了第三弹,在之前的系列教程中我们分别向大家介绍了如何通过使用 MCP 将你的 Figma 设计稿转换为前端代码以及如何用 MCP 实现网页自动化测试,还没看过的小伙伴快去补课吧~
「玩转 MCP 」系列最后一弹将向大家介绍如何在 Trae IDE 中使用高德地图的 MCP Server(amap-maps)来规划旅行行程。通过该实践,你可以在 Trae IDE 中创建一个 “行程规划助手”。根据你的目的地,它可以使用高德地图的 MCP Server 高效地访问地图数据、获取路线信息等,让你的出行规划过程更加便捷和智能!(完整内容同步发布于官方文档站,想在电脑跟练的小伙伴也可以通过这里访问呦~,链接:
)
效果展示
以下示例中,作者使用配置了 MCP Server(amap-maps)的”行程规划助手“制作了一个杭州三日游行程规划。
操作步骤
跟随教程,在项目中集成高德地图的 MCP Server,配置智能体,然后使用指令快速生成一份行程计划。
第一步:安装 Trae IDE
Trae IDE 与 AI 深度集成,提供智能问答、代码自动补全以及基于 Agent 的 AI 自动编程能力。使用 Trae 开发项目时,你可以与 AI 灵活协作,提升开发效率。前往 Trae CN 官网,下载 Trae IDE 的安装包,然后将其安装至你的计算机。
第二步:配置 MCP Sever 的运行环境(已安装的小伙伴可跳至第三步)
为确保正常启动 MCP Server,你需要安装以下依赖:
● npx:依赖于 Node.js,版本需大于等于 18。
● uvx:命令行工具,用于快速运行 Python 脚本。
首先,为便于后续通过命令行安装依赖,让我们在 Trae IDE 中打开终端。步骤如下:
1. 启动 Trae IDE。
2. 在顶部菜单栏中,点击终端 > 新建终端,界面底部显示终端面板。
打开终端后,使用以下步骤安装 uvx:
1. 前往Python官网(链接:),下载并安装 Python 3.8 或更高版本。
2. 安装完成后,在终端中执行以下命令确认是否安装成功。
python3 --version若安装成功,终端中会输出已安装的 Python 的版本号。
3. 执行以下命令,安装 uv(包含 uvx)。
macOS / Linux 安装命令:
curl -LsSf https://astral.sh/uv/install.sh | shWindows 安装命令(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"4. 执行 source $HOME/.local/bin/env 命令,加载 uvx 所需的运行时环境变量和初始化配置。
5. 执行以下命令,验证是否安装成功。
uvx --version若安装成功,终端中会输出已安装的 uvx 的版本号。
uvx 安装完成后,使用以下步骤安装 Node.js:
1. 请前往 Node.js 官网,下载并安装 Node.js 18 或更高版本。
2. 安装完成后,在终端中运行以下命令确认是否安装成功。
node -vnpx -v若安装成功,终端中会输出已安装的 Node.js 的版本号,例如:
v18.19.010.2.03. 重启 Trae IDE 以使 Node.js 生效。
第三步:成为高德地图开发者并创建 Key
成为高德地图开发者,在高德地图开放平台上创建应用并为其添加 Key。后续在 Trae IDE 中接入高德地图 MCP Server 时,需要使用该 Key。
1. 登录高德开放平台(链接:),小编选择的方式为 “短信登录”。
2. 登录完成后,回到高德开放平台首页,点击页面右上角的控制台。
你将前往 注册开发者页面。
4. 根据页面提示,完善信息,然后点击底部的提交材料 按钮。
认证完成后,你将前往控制台。
5. 在左侧导航栏中,点击应用管理 > 我的应用。
你将进入 我的应用面板。
6. 点击右上角的创建新应用按钮。
界面上出现 新建应用弹窗。
7. 输入任意应用名称,将应用类型设置为出行,然后点击新建按钮。
平台将为你新建应用。
8. 应用创建完成后,点击应用条目右侧的添加 Key按钮。
界面上出现 Key 配置窗口。
9. 填入 Key 的名称,将服务平台设置为Web 服务,勾选阅读并同意 高德地图开放平台服务协议 和 高德地图开放平台隐私权政策选框,然后点击提交按钮。
你已成功创建应用并为其添加 Key。
第四步:添加高德地图 MCP Server(amap-maps)
1. 打开 Trae IDE。
2. 在 AI 对话框的右上角,点击设置图标,然后在菜单中选择MCP。
界面上显示 MCP页签。
3. 在MCP页签中,点击+ 添加 MCP Servers按钮。若你已添加过 MCP Server,则点击右侧区域的+ 添加按钮。
你已进入 MCP Server 市场。
4. 手动配置。
界面上显示 手动配置弹窗。
5. 在输入框中粘贴以下配置内容。AMAP_MAPS_API_KEY 部分需要填入 “第三步” 在高德开放平台上创建的 Key。
{"mcpServers": {"amap-maps": {"command": "npx","args": ["-y", "@amap/amap-maps-mcp-server"],"env": {"AMAP_MAPS_API_KEY": "你在高德官网上申请的 key" } } }}6. 点击底部的确认按钮。
高德地图 MCP Server(amap-maps)已被接入 Trae IDE,并已被自动添加至内置智能体 - Builder with MCP。
你可以直接使用 Builder with MCP 来体验高德地图的 MCP Server(参考“第六步”)。若你希望创建一个自定义智能体,通过配置提示词和工具集来使其更好地处理你的需求,请继续往下操作。
第五步:创建自定义智能体并为其配置高德地图 MCP Server
智能体(Agent)是你面向不同开发场景的编程助手。你可以创建自定义智能体,通过灵活配置提示词和工具集,使其更高效地帮你完成复杂任务。
1. 在 AI 对话框的右上角,点击设置图标,然后在菜单中选择智能体。
界面上显示 智能体页签。
2. 点击右侧区域的+ 创建智能体按钮。
智能体配置面板已打开。
3. 配置该智能体:
a.(可选) 上传智能体的头像。
b.输入智能体的名称(例如:行程规划助手)。
c. 配置智能体的提示词。你可以使用以下参考提示词:
你是一个经验丰富的旅行大师,具备成熟的行程规划能力。根据用户提供的目的地,你需要为用户制作详细的行程规划。具体要求如下:## 设计要点- 网格布局,分区清晰- 打印友好:高对比度、合适字体、避免深背景- 使用合适的图标区分活动类型(景点/餐饮/交通等)- 融入简约现代风格和专业旅行指南元素- 制作网页地图,自定义绘制旅游路线和位置- 网页使用简约美观页面风格,景区图片以卡片展示- 行程规划结果在高德地图 app 展示,并集成到 h5 页面中## 必备内容- 行程标题(目的地、日期、天气)- 每日概览(带图标的活动摘要)- 详细时间表(时间/地点/活动/备注)- 交通信息(地图/路线/时间/方式)- 食宿信息(地址/时间/推荐)- 实用信息(紧急电话/注意事项)d. 在工具-MCP部分,仅勾选amap-maps。
e. 在工具-内置部分,文件系统(File System)、终端(Terminal)、联网搜索(Web Search)、预览(Preview)。四个内置工具的作用如下:
● 文件系统:对文件进行增删改查。
● 终端:在终端运行命令,并获取命令的运行状态和结果。
● 联网搜索:搜索和用户任务相关的网页内容。
● 预览:在生成可预览的前端结果后提供预览入口。
配置完成后的面板如下:
4. 点击底部的创建按钮。
智能体创建成功。点击 立即使用按钮,开启与智能体的对话。
第六步:开启对话,制作旅行计划
在上一环节中,点击 立即使用按钮后,系统会自动跳转至 AI 对话框,并默认选用旅行规划助手智能体(若未创建自定义智能体,则使用Builder with MCP)。你可以与该智能体对话,描述你的目的地和出行时间,智能体会调用高德地图中的信息帮你规划行程。步骤如下:
1. 在本地新建一个文件夹,然后在 Trae IDE 中打开它。
2. 在 AI 对话输入框右下角,选择你想使用的模型(本教程使用 DeepSeek-V3-0324)。
3. 输入你的需求并发送(例如:我计划去杭州游玩三天,帮我制作一个旅行攻略,要求如下:包含出行时间、天气状况、路线规划;制作网页地图来绘制旅游路线和位置;网页使用简约美观页面风格,景区图片以卡片展示)。
提示
你可以根据文末“参考信息:高德地图 MCP Server 支持的能力” 来设计需求。智能体开始调用 amap-maps 中的工具和服务,根据你的需求制定旅行计划,并生成可预览的 .html 文件。以下输出过程供参考:
4. 在 .html 文件中输入 “第三步” 中创建的 Key。
提示
若智能体提示你将代码中的 YOUR_AMAP_KEY(也可能是意思相同的其他内容形式,你可以在 .html 文件中搜索关键词 “key” 来定位)替换为有效的高德地图 API Key,则需要操作此步骤,从而确保地图内容可以在 .html 文件中正常展示。5. 打开项目文件中的 .html 文件,预览智能体生成的旅行计划。
6. 持续与智能体对话,优化旅行计划,直至达到让你满意的效果。
参考信息:
高德地图 MCP Server 支持的命令
高德地图 MCP Server 支持的能力如下:
来源:字节跳动技术团队