【Agent】MCP協議 | 用高德MCP Server制作旅游攻略

note

MCP (Model Context Protocol) 代表了 AI 與外部工具和數據交互的標準建立。MCP 的本質：它是一個統一的協議標準，使 AI 模型能夠以一致的方式連接各種數據源和工具，類似于 AI 世界的"USB-C"接口。
- 它能夠在 LLM/AI Agent 與外部資源之間實現無縫、安全且可擴展的數據交換。MCP 采用客戶端-服務器架構，其中 MCP 主機（AI 應用）與 MCP 服務器（數據/工具提供方）進行通信。開發者可以使用 MCP 構建可復用、模塊化的連接器，并利用針對主流平臺的預構建服務器，從而打造一個由社區驅動的生態系統。
MCP 的價值：它解決了傳統 function call 的平臺依賴問題，提供了更統一、開放、安全、靈活的工具調用機制，讓用戶和開發者都能從中受益。
使用與開發：對于普通用戶，MCP 提供了豐富的現成工具，用戶可以在不了解任何技術細節的情況下使用；對于開發者，MCP 提供了清晰的架構和 SDK，使工具開發變得相對簡單。
MCP Server有哪些“服務”？
- Tools：提供給LLM應用特別是Agent使用的工具。
- Resoures：提供給LLM應用一些額外的結構化數據。
- Prompts：提供給LLM應用的一些Prompt模板。比如你的應用是一個Chatbot，可以從MCP Server中取出這些模板，讓使用者選擇使用。

文章目錄

note
一、MCP (Model Context Protocol)
二、高德地圖MCP Server
三、MCP Server 開發實踐
四、高德地圖MCP Server 2.0
- 1、安裝 Cursor
- 2、申請高德開放平臺 WEB 服務API 用戶 key
- 3、Cursor 配置AMap MCP SSE 連接方式
- 4、在cursor上進行交互
Reference

一、MCP (Model Context Protocol)

MCP （Model Context Protocol，模型上下文協議）定義了應用程序和 AI 模型之間交換上下文信息的方式。這使得開發者能夠以一致的方式將各種數據源、工具和功能連接到 AI 模型（一個中間協議層），就像 USB-C 讓不同設備能夠通過相同的接口連接一樣。MCP 的目標是創建一個通用標準，使 AI 應用程序的開發和集成變得更加簡單和統一。

在這里插入圖片描述

相關MCP資源匯總：https://github.com/punkpeye/awesome-mcp-servers

MCP 有潛力成為一個通用接口，可以將其視為 AI 領域的虛擬/軟件版 USB-C。
在這里插入圖片描述

它能夠在 LLM/AI Agent 與外部資源之間實現無縫、安全且可擴展的數據交換。
MCP 采用客戶端-服務器架構，其中 MCP 主機（AI 應用）與 MCP 服務器（數據/工具提供方）進行通信。
開發者可以使用 MCP 構建可復用、模塊化的連接器，并利用針對主流平臺的預構建服務器，從而打造一個由社區驅動的生態系統。

在這里插入圖片描述

MCP Server有哪些“服務”？
- Tools：提供給LLM應用特別是Agent使用的工具。
- Resoures：提供給LLM應用一些額外的結構化數據。
- Prompts：提供給LLM應用的一些Prompt模板。比如你的應用是一個Chatbot，可以從MCP Server中取出這些模板，讓使用者選擇使用。

二、高德地圖MCP Server

高德地圖 MCP Server 是基于 MCP 協議（Model Context Protocol）構建的標準化地圖服務能力平臺。它整合了高德開放平臺的地圖服務與智能算法，將其濃縮為簡單易用的地圖服務接口，為企業及開發者提供全場景的地圖服務解決方案。開發者通過簡單配置，即可快速集成地理編碼、路徑規劃、地點搜索等核心服務接口，輕松調用高德開放平臺的地圖服務與算法能力，加速智慧化業務場景的落地。

12大核心功能

高德地圖 MCP Server 提供12項核心功能，覆蓋多種地圖服務場景，滿足企業開發的多樣化需求：
1、地理編碼：將詳細的結構化地址轉換為經緯度坐標。
在這里插入圖片描述
2、逆地理編碼：將一個高德經緯度坐標轉換為行政區劃地址信息。
3、IP 定位：IP 定位根據用戶輸入的 IP 地址，定位 IP 的所在位置。
4、天氣查詢：根據城市名稱或者標準adcode查詢指定城市的天氣。
5、騎行路徑規劃：用于規劃騎行通勤方案，規劃時會考慮天橋、單行線、封路等情況。最大支持 500km 的騎行路線規劃。
6、步行路徑規劃：可以根據輸入起點終點經緯度坐標，規劃100km 以內的步行通勤方案，并且返回通勤方案的數據。
7、駕車路徑規劃：根據用戶起終點經緯度坐標規劃以小客車、轎車通勤出行的方案，并且返回通勤方案的數據。
8、公交路徑規劃：根據用戶起終點經緯度坐標規劃綜合各類公共（火車、公交、地鐵）交通方式的通勤方案，并且返回通勤方案的數據，跨城場景下必須傳起點城市與終點城市。
9、距離測量：測量兩個經緯度坐標之間的距離，支持駕車、步行以及球面距離測量。
10、關鍵詞搜索：根據用戶傳入關鍵詞，搜索出相關的POI地點信息。
11、周邊搜索：根據用戶傳入關鍵詞以及坐標location，搜索出radius半徑范圍的POI地點信息。
12、詳情查詢：查詢關鍵詞搜或者周邊搜獲取到的POI ID的詳細信息。

三、MCP Server 開發實踐

參考文檔：https://o90p05z3t4.feishu.cn/wiki/Vldsw7DYdiJHe4kmzcJc0wzTnIc

高德開放平臺官網：https://lbs.amap.com/

參考prompt：

# 旅行規劃表設計提示詞你是一位優秀的平面設計師和前端開發工程師，具有豐富的旅行信息可視化經驗，曾為眾多知名旅游平臺設計過清晰實用的旅行規劃表。現在需要為我創建一個A4紙張大小的旅行規劃表，適合打印出來隨身攜帶使用。請使用HTML、CSS和JavaScript代碼實現以下要求：## 基本要求**尺寸與基礎結構**- 嚴格符合A4紙尺寸（210mm×297mm），比例為1:1.414- 適合打印的設計，預留適當的打印邊距（建議上下左右各10mm）- 采用單頁設計，所有重要信息必須在一頁內完整呈現- 信息分區清晰，使用網格布局確保整潔有序- 打印友好的配色方案，避免過深的背景色和過小的字體**技術實現**- 使用打印友好的CSS設計- 提供專用的打印按鈕，優化打印樣式- 使用高對比度的配色方案，確保打印后清晰可讀- 可選擇性地添加虛線輔助剪裁線- 使用Google Fonts或其他CDN加載適合的現代字體- 引用Font Awesome提供圖標支持**專業設計技巧**- 使用圖標和顏色編碼區分不同類型的活動（景點、餐飲、交通等）- 為景點和活動設計簡潔的時間軸或表格布局- 使用簡明的圖示代替冗長文字描述- 為重要信息添加視覺強調（如框線、加粗、不同顏色等）- 在設計中融入城市地標元素作為裝飾，增強辨識度## 設計風格- **實用為主的旅行工具風格**：以清晰的信息呈現為首要目標
- **專業旅行指南風格**：參考Lonely Planet等專業旅游指南的排版和布局
- **信息圖表風格**：將復雜行程轉化為直觀的圖表和時間軸
- **簡約現代設計**：干凈的線條、充分的留白和清晰的層次結構
- **整潔的表格布局**：使用表格組織景點、活動和時間信息
- **地圖元素整合**：在合適位置添加簡化的路線或位置示意圖
- **打印友好的灰度設計**：即使黑白打印也能保持良好的可讀性和美觀## 內容區塊1. **行程標題區**：- 目的地名稱（主標題，醒目位置）- 旅行日期和總天數- 旅行者姓名/團隊名稱（可選）- 天氣信息摘要2. **行程概覽區**：- 按日期分區的行程簡表- 每天主要活動/景點的概覽- 使用圖標標識不同類型的活動3. **詳細時間表區**：- 以表格或時間軸形式呈現詳細行程- 包含時間、地點、活動描述- 每個景點的停留時間- 標注門票價格和必要預訂信息4. **交通信息區**：- 主要交通換乘點及方式- 地鐵/公交線路和站點信息- 預計交通時間- 使用箭頭或連線表示行程路線5. **住宿與餐飲區**：- 酒店/住宿地址和聯系方式- 入住和退房時間- 推薦餐廳列表（標注特色菜和價格區間）- 附近便利設施（如超市、藥店等）6. **實用信息區**：- 緊急聯系電話- 重要提示和注意事項- 預算摘要- 行李清單提醒## 示例內容（基于上海一日游）**目的地**：上海一日游
**日期**：2025年3月30日（星期日）
**天氣**：陰，13°C/7°C，東風1-3級**時間表**：
| 時間 | 活動 | 地點 | 詳情 |
|------|------|------|------|
| 09:00-11:00 | 游覽豫園 | 福佑路168號 | 門票：40元 |
| 11:00-12:30 | 城隍廟午餐 | 城隍廟商圈 | 推薦：南翔小籠包 |
| 13:30-15:00 | 參觀東方明珠 | 世紀大道1號 | 門票：80元起 |
| 15:30-17:30 | 漫步陸家嘴 | 陸家嘴金融區 | 免費活動 |
| 18:30-21:00 | 迪士尼小鎮或黃浦江夜游 | 詳見備注 | 夜游票：120元 |**交通路線**：
- 豫園→東方明珠：乘坐地鐵14號線（豫園站→陸家嘴站），步行10分鐘，約25分鐘
- 東方明珠→迪士尼：地鐵2號線→16號線→11號線，約50分鐘**實用提示**：
- 下載"上海地鐵"APP查詢路線
- 攜帶雨傘，天氣多變
- 避開東方明珠12:00-14:00高峰期
- 提前充值交通卡或準備移動支付
- 城隍廟游客較多，注意保管隨身物品**重要電話**：
- 旅游咨詢：021-12301
- 緊急求助：110（警察）/120（急救）請創建一個既美觀又實用的旅行規劃表，適合打印在A4紙上隨身攜帶，幫助用戶清晰掌握行程安排。

四、高德地圖MCP Server 2.0

1、專屬地圖 Tools：充分理解用戶出行場景訴求，制定出行計劃，并在高德地圖APP生成專屬地圖，滿足用戶打車、導航、酒店預訂、門票預訂、餐廳預訂、加油充電等一系列出行服務需求。

2、喚端Tools & 動態地圖：開發者可以使用高德MCP，直接在出行計劃中載入動態地圖，并嵌入與高德地圖APP聯動按鈕，實現一鍵導航、打車等功能。
在這里插入圖片描述

1、安裝 Cursor

1.本地下載安裝 Cursor 客戶端
2.Cursor 下載安裝地址：https://www.cursor.com/cn
3.登陸 Cursor 個人賬戶建議使用最新版本的 Cursor 客戶端。

2、申請高德開放平臺 WEB 服務API 用戶 key

申請地址：https://console.amap.com/dev/key/app

3、Cursor 配置AMap MCP SSE 連接方式

{"mcpServers": {"amap-amap-sse": {"url": "https://mcp.amap.com/sse?key=<YOUR_API_KEY>"}}
}

4、在cursor上進行交互

query=”用高德MCP，做一個廣州三日游攻略“
在這里插入圖片描述
看中間的called MCP tool過程可知，maps_text_search是一個類似search_for_poi的查點信息的函數：

其他嘗試：尋找約會的中間點、旅游攻略、出游計劃嵌入到app中等

Reference

[1] odel Context Protocol(MCP) 編程極速入門，https://github.com/liaokongVFX/MCP-Chinese-Getting-Started-Guide，有實踐代碼
[2] 地圖上的問題都問它！智能出行規劃專家Claude + 谷歌地圖MCP
[3] 高德地圖 MCP Server：12大核心功能助力企業級智能體應用開發
[4] 高德終端技術總結：高可用架構如何練成？
[5] 爆火的MCP(Model Context Protocol)
[6] https://github.com/punkpeye/awesome-mcp-servers
[7] 一個LangChain與MCP結合使用的案例

其他參考資料：
[1] Introducing the Model Context Protocol:https://www.anthropic.com/news/model-context-protocol
[2]For Claude Desktop Users:https://modelcontextprotocol.io/quickstart/user
[3]Awesome MCP Servers:https://github.com/punkpeye/awesome-mcp-servers
[4]MCP Servers Website:https://mcpservers.org/
[5]Official MCP Servers:https://github.com/modelcontextprotocol/servers
[6]解釋:https://modelcontextprotocol.io/quickstart/server#what%E2%80%99s-happening-under-the-hood[7]源碼:https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/clients/simple-chatbot/mcp_simple_chatbot
[8]client example:https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/clients/simple-chatbot/mcp_simple_chatbot
[9]原始代碼:https://github.com/modelcontextprotocol/python-sdk/blob/main/src/mcp/server/fastmcp/tools/base.py#L34-L73
[10]代碼:https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/clients/simple-chatbot/mcp_simple_chatbot/main.py#L295-L338
[11]代碼:https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/clients/simple-chatbot/mcp_simple_chatbot/main.py#L295-L338[12]最佳開發實踐:https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
[13]TypeScript SDK:https://github.com/modelcontextprotocol/typescript-sdk
[14]Python SDK:https://github.com/modelcontextprotocol/python-sdk
[15]官方文檔:https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
[16]Quick Start: For Server Developers:https://modelcontextprotocol.io/quickstart/server
[17]README 文件:https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/refs/heads/main/README.md
[18]Official Tutorial: Debugging:https://modelcontextprotocol.io/docs/tools/debugging
[19]Official Tutorial: Inspector:https://modelcontextprotocol.io/docs/tools/inspector
[20]MCP Official Docs:https://modelcontextprotocol.io/
[21]MCP Python SDK:https://github.com/modelcontextprotocol/python-sdk
[22]MCP Available Server:https://github.com/modelcontextprotocol/servers
[23]Blog: 🔗What is Model Context Protocol? (MCP) Architecture Overview:https://medium.com/@tahirbalarabe2/what-is-model-context-protocol-mcp-architecture-overview-c75f20ba4498
[24]Blog: LLM Function-Calling vs. Model Context Protocol (MCP):https://www.gentoro.com/blog/function-calling-vs-model-context-protocol-mcp
高德MCP 2.0 出行領域首發打通大模型與高德地圖APP互聯
【Cursor】Cursor的基本使用方式