高德地图 MCP 全网最全教程(Cursor + Win)

7,630 阅读4分钟

欢迎大家加 jianzhangg 进群一起讨论 AI。

本文使用 Cursor 和高德 MCP,使用 AI 做旅游规划,最大的好处是基于地图 MCP,景点、交通信息精准,可以达到可用。文末有西安一日游的路线规划,有没有西安老铁帮忙验证下。

必要步骤,1 获取高德 MCP 的 Key,2 Cursor 配置高德 MCP。

获取高德 MCP 的 Key

高德的官方文档 中也有指导,一共分 3 步。

  1. 注册成为高德开发者。
  2. 新增应用。
  3. 新增应用的 key。

注册成为高德开发者

打开开发者地址,填写手机号用验证码注册后下一步。

image.png

个人选择支付宝认证,再填个邮箱和验证码。

image.png

个人秒审核通过,然后登录去控制台添加应用和 Key。

创建应用和Key

打开 高德控制台,点击新建应用。

image.png

类型选出行。

image.png

创建成功后在这个应用里面选新增 Key。

image.png

服务平台选择 Web 服务,IP 白名单一般不用填。

image.png

复制好创建的 Key,配置 Cursor MCP 会用到。

Cursor 配置高德 MCP

有两种配置方式 SSE 和 npm。

SSE 方式

打开 Cursor 设置,添加此配置。

{
  "mcpServers": {
    "amap-amap-sse": {
      "url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key"
    }
  }
}

image.png

image.png

接着会在 Cursor MCP 里看到高德 MCP 已成功启用。

image.png

SSE 方式经常断,使用前检查下。

npm 方式

npm 方式要先安装 Node,推荐用 nvm 按照,方便切换版本。具体的按照教程上期已经说了,不懂得可以去翻翻。

高德官方推荐用 v22.14.0 版本,并用默认镜像源(registry.npmjs.org/)。

这里说个小坑,我启动了好几次没成功。

一个是用 PowerShell 检查 npm 源时提示没有权限。

PS C:\cursor> npm config get registry  
npm : 无法加载文件 C:\nvm4w\nodejs\npm.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fw  
link/?LinkID=135170 中的 about_Execution_Policies。  
所在位置 行:1 字符: 1  
+ npm config get registry  
+ ~~~  
+ CategoryInfo : SecurityError: (:) [],PSSecurityException  
+ FullyQualifiedErrorId : UnauthorizedAccess  
PS C:\cursor> npm -v  
npm : 无法加载文件 C:\nvm4w\nodejs\npm.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fw  
link/?LinkID=135170 中的 about_Execution_Policies。  
所在位置 行:1 字符: 1

这个直接用 PowerShell 赋权就行。

   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

另一个缓存导致的运行失败,我最开始用的 v20 版本 Node,然后切到 v22 版,缓存没删导致的总是启动失败,报错包找不到,实际上包已经安装了。

C:\cursor\cursor>cmd /c npx -y @amap/amap-maps-mcp-server node:internal/modules/esm/resolve:275 throw new ERR_MODULE_NOT_FOUND( ^ Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'C:\Users\Administrator\AppData\Local\npm-cache\_npx\3f19108e4acac271\node_modules\@modelcontextprotocol\sdk\server\index.js' imported from C:\Users\Administrator\AppData\Local\npm-cache\_npx\3f19108e4acac271\node_modules\@amap\amap-maps-mcp-server\build\index.js at finalizeResolution (node:internal/modules/esm/resolve:275:11) at moduleResolve (node:internal/modules/esm/resolve:860:10) at defaultResolve (node:internal/modules/esm/resolve:984:11) at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:685:12) at #cachedDefaultResolve (node:internal/modules/esm/loader:634:25) at ModuleLoader.resolve (node:internal/modules/esm/loader:617:38) at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:273:38) at ModuleJob._link (node:internal/modules/esm/module_job:135:49) { code: 'ERR_MODULE_NOT_FOUND', url: 'file:///C:/Users/Administrator/AppData/Local/npm-cache/_npx/3f19108e4acac271/node_modules/@modelcontextprotocol/sdk/server/index.js' } Node.js v22.14.0 C:\cursor\cursor>

删除 C:\Users\Administrator\AppData\Local\npm-cache_npx\3f19108e4acac271 目录后重新启动就好了。

Win 在 mcp.json 中的配置和 Mac 不同,命令要用 cmd /c 包一层。

image.png

    "amap-maps": {
      "command": "cmd /c",
      "args": [
        "npx",
        "-y",
        "@amap/amap-maps-mcp-server"
      ],
      "env": {
        "AMAP_MAPS_API_KEY": "你的key"
      }
    }

同样的 MCP 中启动成功即可。

image.png

如果你无法启动,你可以手动复制命令(cmd /c npx -y @amap/amap-maps-mcp-server)在 cmd 中执行,根据报错日志找原因。

MCP 使用

使用就很简单了,我这提示词已经写好了,在 gitee中自取。

image.png

有没有西安老哥帮我看看效果怎么样?

cgi-bin_mmwebwx-bin_webwxgetmsgimg_&MsgID=5375588074772146410&skey=@crypt_2b5c21bf_0faef29e6103776ebd1cda55f370f433&mmweb_appid=wx_webfilehelper.jpg