快速接入腾讯地图MCP Server

随着各类AI大模型的发展，快速推动了产业智能化进程，而AI与外部资源的交互，是应用落地的基础支撑。为了应对用户多样性的需求，产生了丰富的外部工具，但是因为各类大模的不同开发标准，也造成了一个工具无法在不同AI中运行，额外适配要花费大量精力与成本，介于此，MCP协议的推出形成了统一规范，使得AI与外工具的结合更为简单高效，促进了AI的落地化进程。

在AI应用场景中，与真实世界取得连接，进行个性化推荐（推荐餐厅、酒店、活动、景区等），行程规划，获取实时出行信息等，让AI服务于人们现实生活，是很多企业与开发者迫切希望实现的。

对此腾讯位置服务推出基于MCP协议的位置服务开发接口，助开发者们快速实现基于地理位置的AI服务。

腾讯地图MCP Server 产品特点

使用更简单：基于MCP（SSE）方式，不必部署本地服务，简单配置即可。
升级更方便：我们会持续进行迭代改进，云端化服务，您无须任何额外操作
大模型更易理解：我们对原始的JSON结果进行了语义化的转换，更易于大模型理解

腾讯地图MCP Server 功能与使用限制

腾讯位置服务MCP Server依赖地图WebServiceAPI构建，因此受WebServiceAPI接口本身限制，需要具备以下相应接口的调用权限和配额方可使用。
点击查看：WebServiceAPI调用限制说明、WebServiceAPI入门指南

在用户与智能体对话的过程中，智能体根据对话内容判断是否需要调用外部工具（MCPServer）获取信息来解答用户问题，MCPServer根据智能体提供的参数，会调用对应的WebServiceAPI接口获取结果，智能体理解其中内容，并加以整理最后回复给用户。

智能体可能在这一过程中调用多个MCPServer中的工具接口（可能对应多个WebServiceAPI接口），因此相关接口都需要具备调用权限和配额。

我们根据智能体的常见对话场景，在MCP Server中集成如下WebServiceAPI接口：

工具 / 接口名称	接口路径	说明
geocoder 地址解析	/ws/geocoder/v1?address=*	功能：提供由文字地址到经纬度的转换能力，并同时提供结构化的省市区地址信息场景：询问智能体某一具体地址的经纬度时使用，常作用于获取周边搜索、路线规划所需的起终点坐标、搜索中心点坐标时使用
placeSuggestion 关键词输入提示	/ws/place/v1/suggestion	在指定城市或全国范围通过地点名称搜索时使用
reverseGeocoder 逆地址解析	/ws/geocoder/v1?location=*	提供由经纬度到文字地址及相关位置信息的转换能力
placeSearchNearby 地点搜索（周边）	/ws/place/v1/search	功能：提供周边搜索能力场景：在询问智能体在某地附近搜索相关地点时使用
placeAlongby 沿途搜索[高级]	/ws/place/v1/alongby	场景：在询问智能体从某地到某地沿途相关地点时使用，在前置一般会使用到路线规划获取沿途搜索需要的路线坐标点串
placeDetail POI详情查询	/ws/place/v1/detail	提供通过POI ID查询其基础详情信息的能力
directionDriving 驾车路线规划	/ws/direction/v1/driving	功能：根据起点、终点（及途经点），结合算路偏好规划驾车路线场景：与智能体询问某地到某地距离、预估耗时、走哪条路，收费多少等信息时使用
waypointOrder 驾车路线规划 – 途经点智能排序 [高级参数]	/ws/direction/v1/driving?waypoint_order=1	场景：当询问智能体有多个目的地要去，先去哪再去哪整体顺序最优，距离最短
futureDrivingDirection 驾车路线规划 – 未来路线规划 [高级参数]	/ws/direction/v1/driving?departure_time=*	场景：当询问智能体在未来某时间点出发前往某地，驾车所需用时（本接口会参考未来预估路况进行计算，并返回结果）
directionTransit 公交路线规划	/ws/direction/v1/transit	功能：根据起终点经纬度，规划公交/地铁线路乘坐方案，支持指定出发时间（确保线路在首末车时段内），支持时间短、少换乘、少步行等多种偏好，同时返回路线总预估用时、总距离、总步行距离、票价，具体线路如何换乘（线路名、上车站、下车站名等）、首末车时间等
directionBicycling 骑行路线规划	/ws/direction/v1/bicycling	功能：根据起终点经纬度，规划自行车骑行路线，支持返回路线预估用时、总距离等
directionWalking 步行路线规划	/ws/direction/v1/walking	功能：根据起终点经纬度，规划步行路线，支持返回路线预估用时、总距离等
matrix 距离矩阵	驾车：/ws/distance/v1/matrix?mode=driving 步行：/ws/distance/v1/matrix?mode=walking 骑行：/ws/distance/v1/matrix?mode=bicycling	用于批量计算多个起终点到多个终点的路面距离（或称导航距离）
ipLocation IP 定位	/ws/location/v1/ip	通过终端设备IP地址获取其当前所在地理位置
weather 天气查询	/ws/weather/v1	通过行政区划编码，查询对应城市的实时天气或预报天气

应用示例

城市/区域搜索
根据指定的市、区范围（名称或区域代码）、地点关键词，搜索符合的地点信息。应用场景：如搜索北京的景点、酒店、购物场景，搜索某个地方的详细地址等。

（注：不同大模型因其推理、计算能力不同，实际应用效果可能不同，本示例仅供参考）

腾讯位置服务MCP Server 接入步骤

创建APIKey

腾讯位置服务MCP Server（SSE）依赖WebServiceAPI构建，因此需要先创建key，并开启WebServiceAPI功能，取得相关接口调用配额后方可使用，
具体方法可参见： https://lbs.qq.com/service/webService/webServiceGuide/overview

MCP Server服务地址

https://mcp.map.qq.com/sse?key=<YourKey>

参数：key= 即为调用WebServiceAPI所使用的凭据

使用

本文以Cherry Studio为例介绍如何在其中配置MCP Server（其它开发工具可参阅相关指引，总体思想是一致的）

1 . 配置MCP Server 按下图说明进行配置，其中服务地址填入 https://mcp.map.qq.com/sse?key=<您的Key>

2 . 在对话界面，在输入框下方工具中，点击“MCP服务器”，并启用刚刚添加的腾讯位置服务MCP Server。

3 . 在对话获使用

应用效果展示

以下为您展示在使用腾讯MCP Server后，用户与智能体对话过程中的常见地理位置相关场景及其应用效果。
另，因不同大模型其推理、计算能力不同，实际应用效果可能不同，本示例仅供参考

城市/区域搜索

根据指定的市、区范围（名称或区域代码）、地点关键词，搜索符合的地点信息。
应用场景： 如搜索北京的景点、酒店、购物场景，搜索某个地方的详细地址等。

沿途搜索

搜索指路线（经纬度点串）沿途的加油站、充电站、便利店等信息，为出行提供便利。
应用示例： 从腾讯北京总部大楼去西二旗地铁开车有多远，沿途哪里有加油站，我需要加个油
（注：本功能为高级接口，需付费使用）

驾车路线规划

根据起终点经纬度，规划驾车路线，支持参考路况、少收费、不走高速等算路偏好，同时支持返回路线预估用时，路线距离，过路费等信息
应用场景： 从哪去哪，用多长时间，走哪条路，收费多少钱，堵不堵？

驾车路线-途经点智能排序

基于驾车路线规划，对输入的途经点以最顺路方式排序并规划路线，排序途经点最多16个
注：本功能为高级接口，需付费使用。
应用示例： 从北京南站出发，去北京动物园、故宫、南锣鼓巷、天坛等几个地方，最后去我住的酒店，在紫竹桥西北角，先去哪再去哪会比较顺？

未来路线规划

根据起终点经纬度、未来出发时间，规划驾车驾车路线，路线会考虑未来时间的预测路况进行规划，支持返回预估用时、总距离等信息
注：本功能为高级接口，需付费使用。
应用场景： 从哪去哪，5点出发，估计得多久能到？

公交路线规划

根据起终点经纬度，规划公交/地铁线路乘坐方案，支持指定出发时间（确保线路在首末车时段内），支持时间短、少换乘、少步行、地铁优先等多种偏好，为您规划多组乘坐方案，同时返回路线总预估用时、总距离、总步行距离、票价，具体线路如何换乘（线路名、上车站、下车站名等）、首末车时间等
应用场景： 从哪去哪，公交车该怎么坐车？最好能少换乘几趟、另外不想坐地铁