跳转至

18 加餐：MCP产品化！高德、百度、腾讯三大地图服务接入MCP

你好，我是邢云阳。

前一段时间有同学在课程里提出了 MCP 是否目前在生产环境上没什么用，也就是在本地自娱自乐一下的问题。当时我是这么回复的，我说以前产品都是对外提供 OpenAPI，未来可以提供 MCP Server，让使用者通过自然语言调用。

图片

有意思的是，这话刚说完没几天，就偶然看到了百度、腾讯、高德三家地图服务商提供了 MCP Server 的消息，该消息直接验证了我的想法。因此我就抽空加餐一节，为你演示用 Agent 通过 OpenAPI 的方式接入和直接用 MCP 接入，方便你把两种方法做一下对比。

三家地图服务商 MCP Server 实现对比

首先，我们先大致了解一下三家地图服务商的 MCP Server 的实现情况。这三家是同行，我们基本都用过他们的服务，其实基本大差不差，这三家对外提供 MCP Server 的时间点稍有先后，但各家覆盖的接口（API）的数量以及 MCP Server 的实现方式却不尽相同，这也一定程度反映了大家对于新事物的不同看法和思路。

后面我准备了两个表格来做总结。

接口数量与实现方式

接口覆盖功能

可以看到，腾讯位置服务相对做得要更好一点。从技术角度看，它采用 SSE 的方式实现，使用起来更加方便。从接口覆盖场景上来讲，也要更加全面一点。

在第 13 讲时，我们自己实现过一个基于 SSE 协议的 MCP Server 和 Client，当时讲过 SSE 是一个可以建立长连接的轻量级协议。使用 SSE 而不使用 HTTP 的原因是，大模型调用 Tool 的过程不是一轮就结束的，往往是需要多次反复调用。因此，设法保持一个长连接，而不是每一次调用 Tool 的时候就得开个新连接，就显得非常重要了。

接下来，就要接入地图服务了。我以高德地图为例，为你演示 Agent 将 API 当作 Agent Tool 的接入方法。至于高德地图 API Key 的创建，就需要你自行搞定了。

API 接入

我想实现的功能是这样的：当我问大模型“北京鼓楼附近哪有烤鸭店”时，它能调用高德地图服务进行查询。然后总结查询结果后，给我推荐出具体的饭店以及地址。

这个过程用地图官方的专业术语讲叫做搜索 POI，API 文档在这：搜索POI 2.0-高级 API 文档-开发指南-Web服务 API | 高德地图API，一共包含两条 API。

基于文档我编写了两个工具，代码如下：

from llm import client
import requests

tools = [
    {
        "name": "get_location_coordinate",
        "description": "根据POI名称获取其经纬度坐标",
        "parameters": {
            "type": "object",
            "properties": {
                "keywords": {
                    "type": "string",
                    "description": "POI名称（中文）",
                },
                "region": {
                    "type": "string",
                    "description": "POI所在的区域名（中文）",
                }
            },
            "required": ["keywords"]
        },
    },
    {
        "name": "search_nearby_pois",
        "description": "搜索指定坐标附近的POI",
        "parameters": {
            "type": "object",
            "properties": {
                "keywords": {
                    "type": "string",
                    "description": "目标POI的关键字",
                },
                "location": {
                    "type": "string",
                    "description": "中心点坐标（经度,纬度）",
                }
            },
            "required": ["keywords"]
        },
    }
]

def http_get(url, params=None):
    """
    通用的HTTP GET请求处理函数
    
    Args:
        url (str): 完整的请求URL
        params (dict, optional): URL参数字典
    
    Returns:
        dict: 包含success和data/message的响应结果
    """
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        return {"success": True, "data": response.json()}
    except Exception as e:
        return {"success": False, "message": str(e)}

# API配置
AMAP_BASE_URL = "https://restapi.amap.com/v5/place"
AMAP_KEY = "xxxxxxxxxxxxxxxxx"

def get_location_coordinate(keywords, region=None):
    """根据POI名称获取其经纬度坐标"""
    params = {
        "key": AMAP_KEY,
        "keywords": keywords
    }
    if region:
        params["region"] = region
        
    result = http_get(f"{AMAP_BASE_URL}/text", params)
    if result["success"] and result["data"].get("pois"):
        poi = result["data"]["pois"][0]
        return f"POI: {keywords}, 坐标: {poi['location']}"
    return "未找到该POI的坐标信息"


def search_nearby_pois(keywords, location=None):
    """搜索指定坐标附近的POI"""
    params = {
        "key": AMAP_KEY,
        "keywords": keywords
    }
    if location:
        params["location"] = location
        
    result = http_get(f"{AMAP_BASE_URL}/around", params)
    if result["success"] and result["data"].get("pois"):
        results = []
        for poi in result["data"]["pois"][:3]:
            results.append(f"名称: {poi['name']}, 地址: {poi['address']}, 坐标: {poi['location']}")
        return "\n".join(results)
    return "未找到符合条件的POI"

代码是我基于前置课程 Agent 的代码，将高德地图的 API 文档交给 Cursor 后，让 Cursor 生成的，非常易懂，就是一段工具描述加两个 API 调用。写完工具代码，其他的诸如 ReAct 等等就很简单了，照搬前置课程的 Agent 代码即可，只需改改 query 以及工具名称就可以。

代码完成后，我用“北京鼓楼附近哪有烤鸭店”进行了测试，效果是后面这样。

图片

答案是对的，功能没问题。

MCP 方式

对于MCP Server，我们分别测试一下高德和腾讯的，因为它们分别是 Stdio 和 SSE 的，我们都体验一下。

高德地图

先来测试高德地图的， MCP Server 接入文档在这：概述-MCP Server|高德地图API，可以看到其 MCP Server 已经实现好了搜索 POI 的相关工具。其 MCP Server 是用 NodeJS 写的，我们需要在本地配好 NodeJS 环境，然后直接在 MCP Hosts（Cluade、Cline 等）中配置好该 MCP Server 就可以使用。

我依然是在 Windows 上使用 Roo Code 进行测试，配置文件内容如下：

{
  "mcpServers": {
    "amap-maps": {
      "command": "node",
      "args": [
        "D:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npx-cli.js",
        "-y", 
        "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "您在高德官网上申请的key"
      }
    }
  }
}

Mac 用户的配置为：

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "您在高德官网上申请的key"
      }
    }
  }
}

之后，就会看到高德的 MCP Server：

图片

有 12 个工具。

我这次将提示词改一下，增加一个范围信息，这是我看 MCP Server 工具的描述看到的，我的提示词为“北京鼓楼附近500米内哪有烤鸭店”，效果变成了后面这样。

图片

这样做也可以完成任务。

腾讯位置服务

接下来测试腾讯位置服务的，文档在这：MCP Server | 腾讯位置服务，请自行根据文档搞定 API Key 的创建。

那 SSE 的配置文件怎么配呢？以前我以为 Roo Code 只支持 Stdio 的模式，最近经一个同学的提醒，看了下 Roo Code 最新的文档，发现其可以通过配置来搞定 SSE 方式的 MCP Server 的连接。文档在这：Using MCP in Roo Code | Roo Code Docs。

文档给出的示例为：

图片

因此结合腾讯的文档，接入腾讯 MCP Server 的配置是这样。

{
  "mcpServers": {
    "qqmap-server": {
      "url": "https://mcp.map.qq.com/sse?key=<你的密钥>",
      "disabled": false
    }
  }
}

配置好后，就可以看到服务了。

图片

我们仍然使用相同的提示词来测试一下效果。

图片

也没什么问题。这样，两家地图服务的 MCP Server 就测试完毕了。

总结

当我们测试完毕后，再回看文章开头我对那位同学的回复，是不是更能有所体会了呢？

在互联网时代，开发 API 和调用别人的 API 是许多程序员的日常工作。而现在这些服务巨头都与时俱进开始提供大模型开发工具了，这直接就把原本写调用 API 的程序员的饭碗给抢了。

尤其是腾讯这样提供 SSE 方式的，完全就是 OpenAPI 在 AI 时代的究极进化，我只需要开发一个可视化配置的 MCP Hosts，类似这样的：

图片

甚至我们都可以加大力度融入 AI 元素，让用户通过自然语言的聊天完成整个配置。这样一来，不懂代码的普通人都能接入腾讯地图应用，完成地图助手的开发。

技术的迭代速度，正在以我们无法忽视的方式改变行业规则，如果看到高德地图支持 MCP Server 后才开始探索 MCP，那么可能技术的浪潮已经先卷走了很多机会。除了感慨这很可怕之外，我觉得我们唯一的办法就是持续学习、超前学习，毕竟工程师向来是最热衷新事物、具备强大学习能力的一群人。

欢迎你在留言区展示你的思考结果，我们一起探讨。如果你觉得这节课的内容对你有帮助的话，也期待你把它分享给其他朋友，我们下节课再见！

精选留言（9）
  • 迷糊s啦 👍（3） 💬（1）

    云阳老师好，现在mcp服务器火热，形成了“用自然语言操作程序”的潮流。无论是浏览器自动化，还是地图检索，包括与sql的交互，操作本地文件等方面。最后的效果，还是取决于基础大模型的能力以及上下文容量。对于复杂的连续性任务，上下文长度很长的场景，需要做分解和整合，我觉得迫切需要一个能实现这样功能的mcp server。我是非常认可Ilya的超级对齐的理念，mcp server里任何一个函数的调用，都必须要向用户说明意图，并经过用户同意AI再操作。

    2025-04-11

  • 张双双 👍（3） 💬（2）

    已经探索了一个月了，目前在我的应用场景里面，我输入一个包含需求信息的表格，能为我输出各个网络设备的配置文件，里面的配置还挺正确的

    2025-04-10

  • 完美坚持 👍（1） 💬（1）

    你的理解完全对！不管MCP多智能，**“要接入哪些API（比如哪些地图服务、高德、腾讯、百度等），这些可用API的列表，还是得由你（或开发团队）来决定和配置**，MCP只是帮你把调用和数据格式标准化和自动化了。 下面用最通俗的话帮你梳理下： --- ### 1. **API列表是谁来定？** - 必须你来决定要接入哪些API。 - 比如这个“API列表”可以包括高德地图、百度地图、腾讯地图，或者别的业务接口。 - **MCP不会自动帮你找全世界的API，只是帮你管理、统一你选定要用/要接入的API。** --- ### 2. **MCP的核心作用** - 把你选定的API“集中管理”起来，统一接口和数据流。 - 让AI或你的前端应用可以通过“MCP的入口”，像点菜一样选择和调用这些API，无需再为每个API单独做适配。 --- ### 3. **举个例子** - 你配置 MCP Hosts，比如加： - `https://api.amap.com/mcp`（高德的MCP服务） - `https://api.map.qq.com/mcp`（腾讯的MCP服务） - `https://api.baidu.com/mcp`（百度的MCP服务） - 以后AI需要用地图，只需要根据你在“可视化面板”里配置的这些地址去调用，**不用你再写怎么调用高德、腾讯、百度各家API的代码了**。 --- ### 4. **底层API还是你说了算** - MCP不会自动给你找外部接口，**只有你列到MCP的“API菜单”上的接口，AI和你的应用才能用到**。 - 好处是：你只配置一次，“上面的大模型/AI”就能统一调用，有新API也只要点点鼠标就扩展上了。 --- #### 总结一句话： **MCP 让你不用自己写每一个API的对接代码，但“可用API菜单”还是由你来定，MCP只是帮你把它们管起来、用起来更方便！** --- 如需看下你上传文档有没有提到更细的操作方法，可以告诉我，我能帮你快速定位关键部分。

    2025-05-04

  • CrazyCodes 👍（1） 💬（2）

    老师，截图软件叫啥名字。。

    2025-04-29

  • ybduan 👍（1） 💬（1）

    文中的高德mcp server是运行在本地机器上的吗？

    2025-04-28

  • Feng 👍（1） 💬（1）

    现在探索还有机会吗

    2025-04-10

  • Geek_682837 👍（1） 💬（5）

    使用腾讯地图sse的方式，mcp服务连上了能看到工具列表了，但是对话使用的时候一直报签名验证失败，老师这种情况有遇到过吗

    2025-04-09

  • ifelse 👍（0） 💬（1）

    学习打卡

    2025-04-18

  • metallica_wuge 👍（0） 💬（0）

    想再看下这样的对比：【同样是基于LangChain开发满足上述场景的智能体】，一种是在高德尚未支持MCP时，通过API工具调用实现，一种是高德支持MCP后，将现有代码改造成MCP方式对接，对比开发层面的差异。

    2025-05-08