閱讀(197) 書(shū)簽贊(0) 我要糾錯(cuò)

MCP 教程：使用高德地圖 MCP Server 規(guī)劃行程

2025-06-17 16:23 更新

本文將重點(diǎn)介紹如何在 Trae IDE 中使用高德地圖的 MCP Server（amap-maps）來(lái)規(guī)劃旅行行程。通過(guò)該最佳實(shí)踐，你可以在 Trae IDE 中創(chuàng)建一個(gè) “行程規(guī)劃助手”。根據(jù)你的目的地，它可以使用高德地圖的 MCP Server 高效地訪(fǎng)問(wèn)地圖數(shù)據(jù)、獲取路線(xiàn)信息等，讓你的出行規(guī)劃過(guò)程更加便捷和智能。

效果展示

以下示例中，作者使用配置了 MCP Server（amap-maps）的 ”行程規(guī)劃助手“ 制作了一個(gè)杭州三日游行程規(guī)劃。

演示環(huán)境

本教程中，小編使用的系統(tǒng)環(huán)境如下：

Trae IDE 版本：0.5.5
macOS 版本：14.7
Node.js 版本：20.19.1
npx 版本：10.9.2
Python 版本：3.13.3
uvx 版本：0.6.16

操作步驟

跟隨教程，在項(xiàng)目中集成高德地圖的 MCP Server，配置智能體，然后使用指令快速生成一份行程計(jì)劃。

第一步：安裝 Trae IDE

Trae IDE 與 AI 深度集成，提供智能問(wèn)答、代碼自動(dòng)補(bǔ)全以及基于 Agent 的 AI 自動(dòng)編程能力。使用 Trae 開(kāi)發(fā)項(xiàng)目時(shí)，你可以與 AI 靈活協(xié)作，提升開(kāi)發(fā)效率。前往 Trae CN 官網(wǎng)，下載 Trae IDE 的安裝包，然后將其安裝至你的計(jì)算機(jī)。

第二步：配置 MCP Sever 的運(yùn)行環(huán)境

為確保正常啟動(dòng) MCP Server，你需要安裝以下依賴(lài)：

npx：依賴(lài)于 Node.js，版本需大于等于 18。
uvx：命令行工具，用于快速運(yùn)行 Python 腳本。

首先，為便于后續(xù)通過(guò)命令行安裝依賴(lài)，讓我們?cè)?Trae IDE 中打開(kāi)終端。步驟如下：

啟動(dòng) Trae IDE。
在頂部菜單欄中，點(diǎn)擊終端 > 新建終端。

界面底部顯示終端面板。

打開(kāi)終端后，使用以下步驟安裝 uvx：
前往 Python 官網(wǎng)，下載并安裝 Python 3.8 或更高版本。
安裝完成后，在終端中執(zhí)行以下命令確認(rèn)是否安裝成功。
```
python3 --version
```
若安裝成功，終端中會(huì)輸出已安裝的 Python 的版本號(hào)。
執(zhí)行以下命令，安裝 uv（包含 uvx）。
- macOS / Linux 安裝命令：
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
- Windows 安裝命令（PowerShell）：
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
執(zhí)行 source $HOME/.local/bin/env 命令，加載 uvx 所需的運(yùn)行時(shí)環(huán)境變量和初始化配置。
執(zhí)行以下命令，驗(yàn)證是否安裝成功。
```
uvx --version
```
若安裝成功，終端中會(huì)輸出已安裝的 uvx 的版本號(hào)。

uvx 安裝完成后，使用以下步驟安裝 Node.js：

請(qǐng)前往 Node.js 官網(wǎng)，下載并安裝 Node.js 18 或更高版本。
安裝完成后，在終端中運(yùn)行以下命令確認(rèn)是否安裝成功。
```
node -v
npx -v
```
若安裝成功，終端中會(huì)輸出已安裝的 Node.js 的版本號(hào)，例如：
```
v18.19.0
10.2.0
```
重啟 Trae IDE 以使 Node.js 生效。

第三步：成為高德地圖開(kāi)發(fā)者并創(chuàng)建 Key

成為高德地圖開(kāi)發(fā)者，在高德地圖開(kāi)放平臺(tái)上創(chuàng)建應(yīng)用并為其添加 Key。后續(xù)在 Trae IDE 中接入高德地圖 MCP Server 時(shí)，需要使用該 Key。

登錄高德開(kāi)放平臺(tái)（作者選擇的方式為 “短信登錄”）。
登錄完成后，回到高德開(kāi)放平臺(tái)首頁(yè)，點(diǎn)擊頁(yè)面右上角的 控制臺(tái)。

你將前往 注冊(cè)開(kāi)發(fā)者 頁(yè)面。
在 個(gè)人認(rèn)證開(kāi)發(fā)者 部分，選擇 個(gè)人支付寶掃碼認(rèn)證。
根據(jù)頁(yè)面提示，完善信息，然后點(diǎn)擊底部的 提交材料 按鈕。

認(rèn)證完成后，你將前往控制臺(tái)。
在左側(cè)導(dǎo)航欄中，點(diǎn)擊 應(yīng)用管理 > 我的應(yīng)用。

你將進(jìn)入 我的應(yīng)用 面板。
點(diǎn)擊右上角的 創(chuàng)建新應(yīng)用 按鈕。

界面上出現(xiàn) 新建應(yīng)用 彈窗。

輸入任意應(yīng)用名稱(chēng)，將應(yīng)用類(lèi)型設(shè)置為出行，然后點(diǎn)擊新建按鈕。

平臺(tái)將為你新建應(yīng)用。
應(yīng)用創(chuàng)建完成后，點(diǎn)擊應(yīng)用條目右側(cè)的 添加 Key 按鈕。

界面上出現(xiàn) Key 配置窗口。
填入 Key 的名稱(chēng)，將 服務(wù)平臺(tái) 設(shè)置為 Web 服務(wù)，勾選 閱讀并同意高德地圖開(kāi)放平臺(tái)服務(wù)協(xié)議和高德地圖開(kāi)放平臺(tái)隱私權(quán)政策 選框，然后點(diǎn)擊提交按鈕。

你已成功創(chuàng)建應(yīng)用并為其添加 Key。

第四步：添加高德地圖 MCP Server（amap-maps）

打開(kāi) Trae IDE。
在 AI 對(duì)話(huà)框的右上角，點(diǎn)擊 設(shè)置 圖標(biāo)，然后在菜單中選擇 MCP。

界面上顯示 MCP 頁(yè)簽。
在 MCP 頁(yè)簽中，點(diǎn)擊 + 添加 MCP Servers 按鈕。若你已添加過(guò) MCP Server，則點(diǎn)擊右側(cè)區(qū)域的 + 添加 按鈕。

你已進(jìn)入 MCP Server 市場(chǎng)。
點(diǎn)擊 手動(dòng)配置。

界面上顯示 手動(dòng)配置 彈窗。

在輸入框中粘貼以下配置內(nèi)容。AMAP_MAPS_API_KEY 部分需要填入 “第三步” 在高德開(kāi)放平臺(tái)上創(chuàng)建的 Key。

{
"mcpServers": {
"amap-maps": {
  "command": "npx",
  "args": ["-y", "@amap/amap-maps-mcp-server"],
  "env": {
    "AMAP_MAPS_API_KEY": "你在高德官網(wǎng)上申請(qǐng)的 key"
  }
}
}
}

點(diǎn)擊底部的 確認(rèn) 按鈕。

高德地圖 MCP Server（amap-maps）已被接入 Trae IDE，并已被自動(dòng)添加至內(nèi)置智能體 - Builder with MCP。

你可以直接使用 Builder with MCP 來(lái)體驗(yàn)高德地圖的 MCP Server（參考“第六步”）。若你希望創(chuàng)建一個(gè)自定義智能體，通過(guò)配置提示詞和工具集來(lái)使其更好地處理你的需求，請(qǐng)繼續(xù)往下操作。

第五步：創(chuàng)建自定義智能體并為其配置高德地圖 MCP Server

智能體（Agent）是你面向不同開(kāi)發(fā)場(chǎng)景的編程助手。你可以創(chuàng)建自定義智能體，通過(guò)靈活配置提示詞和工具集，使其更高效地幫你完成復(fù)雜任務(wù)。

在 AI 對(duì)話(huà)框的右上角，點(diǎn)擊 設(shè)置 圖標(biāo)，然后在菜單中選擇 智能體。

界面上顯示 智能體 頁(yè)簽。
點(diǎn)擊右側(cè)區(qū)域的 + 創(chuàng)建智能體 按鈕。

智能體配置面板已打開(kāi)。

配置該智能體：

a. (可選) 上傳智能體的頭像。

b. 輸入智能體的名稱(chēng)（例如：行程規(guī)劃助手）。

c. 配置智能體的提示詞。你可以使用以下參考提示詞：

你是一個(gè)經(jīng)驗(yàn)豐富的旅行大師，具備成熟的行程規(guī)劃能力。根據(jù)用戶(hù)提供的目的地，你需要為用戶(hù)制作詳細(xì)的行程規(guī)劃。具體要求如下：




## 設(shè)計(jì)要點(diǎn)
- 網(wǎng)格布局，分區(qū)清晰
- 打印友好：高對(duì)比度、合適字體、避免深背景
- 使用合適的圖標(biāo)區(qū)分活動(dòng)類(lèi)型（景點(diǎn)/餐飲/交通等）
- 融入簡(jiǎn)約現(xiàn)代風(fēng)格和專(zhuān)業(yè)旅行指南元素
- 制作網(wǎng)頁(yè)地圖，自定義繪制旅游路線(xiàn)和位置
- 網(wǎng)頁(yè)使用簡(jiǎn)約美觀頁(yè)面風(fēng)格，景區(qū)圖片以卡片展示
- 行程規(guī)劃結(jié)果在高德地圖 app 展示，并集成到 h5 頁(yè)面中




## 必備內(nèi)容
- 行程標(biāo)題（目的地、日期、天氣）
- 每日概覽（帶圖標(biāo)的活動(dòng)摘要）
- 詳細(xì)時(shí)間表（時(shí)間/地點(diǎn)/活動(dòng)/備注）
- 交通信息（地圖/路線(xiàn)/時(shí)間/方式）
- 食宿信息（地址/時(shí)間/推薦）
- 實(shí)用信息（緊急電話(huà)/注意事項(xiàng)）

d. 在 工具-MCP 部分，僅勾選 amap-maps。

e. 在 工具-內(nèi)置 部分，文件系統(tǒng)（File System）、終端（Terminal）、聯(lián)網(wǎng)搜索（Web Search）、預(yù)覽（Preview）。四個(gè)內(nèi)置工具的作用如下：

文件系統(tǒng)：對(duì)文件進(jìn)行增刪改查。
終端：在終端運(yùn)行命令，并獲取命令的運(yùn)行狀態(tài)和結(jié)果。
聯(lián)網(wǎng)搜索：搜索和用戶(hù)任務(wù)相關(guān)的網(wǎng)頁(yè)內(nèi)容。
預(yù)覽：在生成可預(yù)覽的前端結(jié)果后提供預(yù)覽入口。

配置完成后的面板如下：

點(diǎn)擊底部的 創(chuàng)建 按鈕。

智能體創(chuàng)建成功。點(diǎn)擊 立即使用 按鈕，開(kāi)啟與智能體的對(duì)話(huà)。

第六步：開(kāi)啟對(duì)話(huà)，制作旅行計(jì)劃

在上一環(huán)節(jié)中，點(diǎn)擊 立即使用 按鈕后，系統(tǒng)會(huì)自動(dòng)跳轉(zhuǎn)至 AI 對(duì)話(huà)框，并默認(rèn)選用 旅行規(guī)劃助手 智能體（若未創(chuàng)建自定義智能體，則使用 Builder with MCP）。你可以與該智能體對(duì)話(huà)，描述你的目的地和出行時(shí)間，智能體會(huì)調(diào)用高德地圖中的信息幫你規(guī)劃行程。步驟如下：

在本地新建一個(gè)文件夾，然后在 Trae IDE 中打開(kāi)它。
在 AI 對(duì)話(huà)輸入框右下角，選擇你想使用的模型（本教程使用 DeepSeek-V3-0324）。
輸入你的需求并發(fā)送（例如：我計(jì)劃去杭州游玩三天，幫我制作一個(gè)旅行攻略，要求如下：包含出行時(shí)間、天氣狀況、路線(xiàn)規(guī)劃；制作網(wǎng)頁(yè)地圖來(lái)繪制旅游路線(xiàn)和位置；網(wǎng)頁(yè)使用簡(jiǎn)約美觀頁(yè)面風(fēng)格，景區(qū)圖片以卡片展示）。

提示
你可以根據(jù) ”參考信息：高德地圖 MCP Server 支持的能力“ 部分來(lái)設(shè)計(jì)需求。

智能體開(kāi)始調(diào)用 amap-maps 中的工具和服務(wù)，根據(jù)你的需求制定旅行計(jì)劃，并生成可預(yù)覽的 .html 文件。以下輸出過(guò)程供參考：
在 .html 文件中輸入 “第三步” 中創(chuàng)建的 Key。

提示
若智能體提示你將代碼中的 YOUR_AMAP_KEY（也可能是意思相同的其他內(nèi)容形式，你可以在 .html 文件中搜索關(guān)鍵詞 “key” 來(lái)定位）替換為有效的高德地圖 API Key，則需要操作此步驟，從而確保地圖內(nèi)容可以在 .html 文件中正常展示。
打開(kāi)項(xiàng)目文件中的 .html 文件，預(yù)覽智能體生成的旅行計(jì)劃。
持續(xù)與智能體對(duì)話(huà)，優(yōu)化旅行計(jì)劃，直至達(dá)到讓你滿(mǎn)意的效果。

參考信息：高德地圖 MCP Server 支持的命令

高德地圖 MCP Server 支持的能力如下：

API 方法	能力
maps_regeocode	將一個(gè)高德經(jīng)緯度坐標(biāo)轉(zhuǎn)換為行政區(qū)劃地址信息。
maps_gep	將詳細(xì)的結(jié)構(gòu)化地址轉(zhuǎn)換為經(jīng)緯度坐標(biāo)。支持將地標(biāo)性名勝景區(qū)、建筑物名稱(chēng)解析為經(jīng)緯度坐標(biāo)。
maps_ip_location	IP 定位：根據(jù)用戶(hù)輸入的 IP 地址，定位 IP 的所在位置。
maps_whether	根據(jù)城市名稱(chēng)或者標(biāo)準(zhǔn) adcode 查詢(xún)制定城市的天氣。
maps_search_detail	通過(guò)“關(guān)鍵詞搜”或“周邊搜”能力獲取到的 POI ID 的詳細(xì)信息。
maps_bicycling	騎行路徑規(guī)劃：用戶(hù)規(guī)劃騎行通勤方案，規(guī)劃時(shí)會(huì)考慮天橋、單行線(xiàn)、封路等情況。最大支持 500km 的騎行路線(xiàn)規(guī)劃。
maps_direction_walking	步行路徑規(guī)劃：根據(jù)輸入起點(diǎn)終點(diǎn)經(jīng)緯度坐標(biāo)，規(guī)劃 100km 以?xún)?nèi)的步行通勤方案，并且返回通勤方案的數(shù)據(jù)。
maps_direction_driving	駕車(chē)路徑規(guī)劃：根據(jù)用戶(hù)起終點(diǎn)經(jīng)緯度坐標(biāo)規(guī)劃以小客車(chē)、轎車(chē)通勤出行的方案，并且返回通勤方案的數(shù)據(jù)。
maps_direction_transit_integrated	公交路徑規(guī)劃：根據(jù)用戶(hù)起終點(diǎn)經(jīng)緯度坐標(biāo)規(guī)劃綜合各類(lèi)公共（火車(chē)、公交、地鐵）交通方式的通勤方案，并且返回通勤方案的數(shù)據(jù)，跨城場(chǎng)景下必須傳起點(diǎn)城市與終點(diǎn)城市。
maps_distance	距離測(cè)量：測(cè)量?jī)蓚€(gè)經(jīng)緯度坐標(biāo)之間的距離，支持駕車(chē)、步行以及球面距離測(cè)量。
maps_text_search	關(guān)鍵詞搜：根據(jù)用戶(hù)傳入關(guān)鍵詞，搜索出相關(guān)的 POI 地點(diǎn)信息。
maps_around_search	周邊搜：根據(jù)用戶(hù)傳入關(guān)鍵詞以及坐標(biāo) location，搜索出 radius 半徑范圍的 POI 地點(diǎn)信息。

了解更多

若想了解更多模型上下文協(xié)議（MCP）和智能體的相關(guān)信息，參閱以下文檔：

以上內(nèi)容是否對(duì)您有幫助：

← MCP 教程：實(shí)現(xiàn)網(wǎng)頁(yè)自動(dòng)化測(cè)試

Trae 中文教程 Chat 模式：提升開(kāi)發(fā)效率的 AI 編程助手 →

寫(xiě)筆記

我要補(bǔ)充

查看完整版筆記

国产chinesehdxxxx野外,国产av无码专区亚洲av琪琪,播放男人添女人下边视频,成人国产精品一区二区免费看,chinese丰满人妻videos