# 高德地图

地点与天气查询、路线规划、地图生成和地图开发。

- 类型：MCP · Skill · CLI
- 权限：只读查询
- 门槛：需授权账号、需 API Key
- 官方入口：https://developer.amap.com/api/mcp-server/summary
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/amap/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。

## 接入前准备

查地点和路线可先接 MCP：需要高德开放平台账号和申请的 Key；配额、使用范围与费用以控制台为准。地图 GUI CLI 与 JS API Skill 是另一条地图开发路径，不必全部安装。

## 接入步骤

1. 按 MCP 快速接入文档注册开发者、创建应用并申请 Key，由你在本地填写。 [官方入口](https://developer.amap.com/api/mcp-server/gettingstarted)
2. 让 Agent 使用下方 Streamable HTTP 配置，保留完整 URL 并替换 Key；客户端不支持该协议时先查客户端官方配置方式。 [官方入口](https://developer.amap.com/api/mcp-server/gettingstarted)
3. 只有需要地图可视化时再选地图 GUI CLI：它另需 Web端(JS API) Key 和安全密钥，设置 AMAP_KEY、AMAP_SECURITY_KEY 后启动；不要把两条路线的密钥要求混用。 [官方入口](https://developer.amap.com/api/cli/map-cli/install)

## 验证方法

先确认客户端列出高德工具，再用公开地点做一次只读查询，例如查询北京站地址。返回实际地点结果才说明可用；鉴权或配额报错时按控制台处理，安装成功不等于查询成功。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

高德开放平台基础服务按用途和开发者类型提供月配额，超额需购买；企业商业用途须购买技术服务许可。基础 LBS 和基础搜索服务列价为 30 元/万次（可能适用折扣）；MCP 是否另收调用费，接入页未说明。 [官方来源](https://lbs.amap.com/upgrade)（核对日期：2026-11-05）

官方原文：月配额超限后可付费购买

## 安装配置

### JSON

```
{
  "mcpServers": {
    "amap": {
      "type": "http",
      "url": "https://mcp.amap.com/mcp?key=${AMAP_KEY}"
    }
  }
}
```

### Claude Code

```
claude mcp add --transport http 'amap' 'https://mcp.amap.com/mcp?key=${AMAP_KEY}'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.amap]
url = "https://mcp.amap.com/mcp?key=<你的高德Key>"
```

### CLI

```
npm install -g @amap-lbs/amap-gui
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

- [官方 Skill](https://github.com/AMap-Web/amap-skills)

## 核验与来源

2026-11-05 核对官方身份：[依据](https://developer.amap.com/api/mcp-server/gettingstarted)。官方 MCP 快速接入文档，并由官方导航确认 Skill 与 CLI。

官方原文摘录（2026-11-05，来自上述依据）：

```
"url": "https://mcp.amap.com/mcp?key=您在高德官网上申请的key"
```


[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)