从零开始:Dify 接入高德地图 MCP Server 完整教程
本教程将带你一步步实现 Dify 与高德地图 MCP Server 的集成,让你轻松为 AI 应用接入地图、导航、天气等实用服务。无论你是开发者还是 AI 爱好者,都能按此流程快速上手。
1. 你必须了解的基础概念
1.1 什么是 MCP 协议?
MCP(Model Context Protocol,模型上下文协议)由 AI 公司 Anthropic 于 2024 年 11 月提出,是一种开放标准协议,常被比作 “AI 界的 USB-C 接口”。它的核心作用是打通大语言模型(LLM)与外部工具、数据源之间的壁垒,让 AI 能够动态调用数据库、导航软件、办公工具等资源。
MCP 协议采用 客户端 - 服务器(CS)架构,包含三个关键组件:
- MCP Hosts: 发起连接的 AI 应用程序(如 Claude Desktop、Dify)。
- MCP Clients: 运行在主机内的客户端,与 MCP Server 保持一对一连接,负责协议通信。
- MCP Servers: 向客户端提供资源、提示和工具的服务器。
1.2 高德地图 MCP Server 是什么?
高德地图开放平台基于 MCP 协议,提供了 12 大核心服务接口,覆盖全场景地图功能:
- 地理编码 / 逆地理编码: 地址 ↔ 坐标互转
- IP 定位: 根据 IP 获取位置
- 天气查询: 实时天气信息
- 路径规划: 骑行、步行、驾车、公交四种模式
- 距离测量: 两点间距离计算
- 搜索服务: 关键词搜索、周边搜索、详情搜索
高德地图 MCP Server 的 Tool 名称如下:
maps_direction_bicycling— 骑行路径规划maps_direction_driving— 驾车路径规划maps_direction_transit_integrated— 公交路径规划maps_direction_walking— 步行路径规划maps_distance— 距离测量maps_geo— 地理编码maps_regeocode— 逆地理编码maps_ip_location— IP 定位maps_around_search— 周边搜索maps_search_detail— 详情搜索maps_text_search— 关键词搜索maps_weather— 天气查询
接入方式简单:通过 SSE(Server-Sent Events) 连接,只需在高德开放平台获取 API Key 并配置到 MCP 客户端即可。
1.3 Dify 是什么?
Dify 是一个强大的 AI 应用开发平台,支持通过 SSE 接入 MCP Server。它提供丰富的插件系统,通过安装 MCP SSE 插件,可轻松对接高德地图 MCP Server,让 AI 模型动态调用地图服务。
2. 手把手搭建:接入步骤详解
以下是完整接入流程,请按顺序操作。
第一步:获取高德地图 MCP Server 的 Key
- 注册高德开放平台账号
访问 高德开放平台官网,点击右上角「登录」,使用信息登录方式注册。 - 开发者认证
登录后点击右上角「控制台」,进行开发者认证。个人选择「个人认证开发者」,企业选择「企业认证开发者」。
- 创建应用并获取 Key
在控制台选择「应用管理 → 我的应用」,点击「创建新应用」。填写应用名称和类型。
创建成功后点击「添加 Key」,填写 Key 名称并选择服务平台为 Web 服务,提交后即可获得 Key。
