Dify应用5分钟接入高德MCP私人出行助理轻松get

显示全部楼层

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(15, 76, 129);">Gaode MCP ↔ dify对接流程，只保留与集成直接相关的核心操作，5分钟把高德能力塞进 Dify App。拿来即用。

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;display: table;padding: 0px 0.2em;color: rgb(255, 255, 255);background: rgb(15, 76, 129);">1. 快速部署高德 MCP Server

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;font-style: normal;padding: 1em;border-radius: 6px;color: rgba(0, 0, 0, 0.5);background: rgb(247, 247, 247);">
ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 1em;display: block;letter-spacing: 0.1em;color: rgb(63, 63, 63);">ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(15, 76, 129);">前提：已在高德开放平台申请到ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-feature-settings: normal;font-variation-settings: normal;font-size: 14.4px;text-align: left;line-height: 1.75;color: rgb(221, 17, 68);background: rgba(27, 31, 35, 0.05);padding: 3px 5px;border-radius: 4px;">Web API Key且开启所需服务（路线规划、逆地理、天气等）。

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;padding-left: 8px;color: rgb(63, 63, 63);">常规操作

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">下面介绍一种简单的，不需要动手的

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-feature-settings: normal;font-variation-settings: normal;font-size: 14.4px;margin: 10px 8px;color: rgb(201, 209, 217);background: rgb(13, 17, 23);text-align: left;line-height: 1.5;overflow-x: auto;border-radius: 8px;padding: 0px !important;"># ① 安装
pip install amap-mcp-server      # 也可用 npx -y @amap/amap-maps-mcp-server

# ② 配环境变量
exportAMAP_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服务

打开魔搭社区的MCP广场^[1]

选择对应的高德MCP，填入自己申请的key后，一键部署。

可以根据右边的SSE服务地址，完成后续内容

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	用 Nginx/Caddy 反向代理`https://mcp.yourdomain.com/sse`，证书同域名
并发 & 超时	`uvicorn --workers 4` ; 适当调大`timeout`、`sse_read_timeout`
限流	Nginx`limit_req zone=mcp 5r/s burst=10`，防止过载
监控	Prometheus 抓取`/metrics`或自定义中间件；Grafana 面板
日志	stdout → Loki / Graylog；关键错误告警到 Slack / 飞书

常见坑速查

现象	处理
Dify 提示schema parse error	升级`amap-mcp-server >= 0.3.2`
返回空路线 / 天气	高德 Key 未开对应权限或配额不足
`ERR_EMPTY_RESPONSE`	端口未监听 / 被防火墙拦截；`lsof -i:8000`排查

6.使用时的常见问题

1. 调用MCP服务后，返回结果的时间就会延长
2. 针对一些热门路线，大模型可能不会调用MCP服务

Dify应用需求，敬请联系