Gaode MCP ↔ dify 对接流程，只保留与集成直接相关的核心操作，5分钟把高德能力塞进 Dify App。拿来即用。
1. 快速部署 高德 MCP Server
前提：已在高德开放平台申请到
Web API Key且开启所需服务（路线规划、逆地理、天气等）。
常规操作
下面介绍一种简单的，不需要动手的
# ① 安装
pip install amap-mcp-server # 也可用 npx -y @amap/amap-maps-mcp-server
# ② 配环境变量
export AMAP_MAPS_API_KEY="<你的Key>"
# ③ 启动（SSE 推荐给 Dify）
amap-mcp-server
--host 0.0.0.0
--port 8000
--transport sse # 重要：Dify 的 MCP 插件默认走 SSE连通性自检：
curl http://127.0.0.1:8000/schema | jq .title
# 预期输出 "Gaode Maps MCP Server"10秒获得专属自己的高德MCP服务
2. 在 Dify 配置MCP
-
1. 工具 安装 MCP。
Dify添加MCP服务应用。将前图中SSE链接粘贴复制到URL上，然后等待一会。
-
2. 安装完成后点击 Authorize，粘贴下列配置（如本地测试保持 127.0.0.1；上服务器时改用域名 / HTTPS）：
{
"mcpServers": {
"gaode": {
"transport": "sse",
"url": "http://127.0.0.1:8000/sse",
"timeout": 50,
"sse_read_timeout": 50
}
}
}直接输入url就可以
-
3. 保存即完成MCP服务注册。
Dify MCP服务添加成功的界面
3. 创建Dify应用并配置MCP服务
-
1. 创建Agent应用。
选择Agent应用创建。 -
2. 选中对应的MCP，Dify 会自动读取 /schema，把 12 个地图库函数注入到当前模型的 tool list。 -
3. 点击 发布。
发布成功后，可以直接在web窗口使用。
4. 验证一次端到端
在 Chat 窗输入：
帮我规划从「上海外滩」到「虹桥机场」的驾车路线
-
• LLM 会检测到路线规划意图，自动调用 maps_driving_by_address。 -
• Gaode MCP Server 返回 JSON 路径数据 → LLM 将其转成自然语言输出。
若回复中带有路线里程、耗时，即说明集成成功。
5. 生产环境加固要点（选做）
|
|
|
|---|---|
| HTTPS |
https://mcp.yourdomain.com/sse，证书同域名 |
| 并发 & 超时 | uvicorn --workers 4
timeout、sse_read_timeout |
| 限流 |
limit_req zone=mcp 5r/s burst=10，防止过载 |
| 监控 |
/metrics 或自定义中间件；Grafana 面板 |
| 日志 |
|
常见坑速查
|
|
|
|---|---|
|
|
amap-mcp-server >= 0.3.2 |
|
|
|
ERR_EMPTY_RESPONSE |
lsof -i:8000 排查 |
6.使用时的常见问题
-
1. 调用MCP服务后，返回结果的时间就会延长 -
2. 针对一些热门路线，大模型可能不会调用MCP服务
Dify应用需求，敬请联系
