跳到主要内容

腾讯位置服务 MCP 接入

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

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

前往云开发平台创建 MCP Server


环境变量

创建APIKey 腾讯位置服务MCP 依赖WebServiceAPI构建,因此需要先创建key,并开启WebServiceAPI功能,取得相关接口调用配额后方可使用,

具体方法可参见: https://lbs.qq.com/service/webService/webServiceGuide/overview

  • 需要将 API_KEY 环境变量配置为您在腾讯位置服务创建的 API Key

使用说明

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

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

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

应用示例

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

(注:不同大模型因其推理、计算能力不同,实际应用效果可能不同,本示例仅供参考)

🗺️ 功能清单

工具标识功能描述核心参数
geocoder提供由文字地址到经纬度的转换能力,并返回结构化的省市区地址信息address(必填,包含省市区信息的格式化地址或包含城市名的地点关键词)
placeSuggestion根据关键词和城市搜索地点信息,返回地点名称、地址、经纬度、分类等keyword(必填,关键词或地点名称),region(选填,搜索城市)
placeSearchNearby搜索指定中心点经纬度周边的地点信息,返回地点名称、地址、经纬度、分类等location(必填,搜索中心点经纬度,格式 lat,lng),keyword(必填,搜索关键词)
directionDriving规划驾车路线,支持参考路况、少收费、不走高速等偏好,返回路线预估用时、距离、过路费等信息from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng
placeAlongby在路线沿途搜索符合条件的地点,返回地点名称、地址、经纬度、分类等polyline(必填,路线经纬度点串),keyword(必填,搜索关键词)
placeDetail根据 POI ID 获取 POI 详情信息,包括名称、地址、经纬度、分类等id(必填,POI ID)
matrix批量计算多个起终点之间的路面距离(导航距离)from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng),mode(必填,通行方式:drivingwalkingbicycling
reverseGeocoder输入经纬度坐标,返回语义化地址、省市区信息等location(必填,经纬度坐标,格式 lat,lng
ipLocation通过 IP 地址获取当前所在省、市、区信息ip(必填,IP 地址,IPv4 或 IPv6)
weather查询行政区划代码对应的城市实时天气或预报天气adcode(必填,行政区划代码),type(选填,查询类型:nowfuture,默认为 now
directionWalking规划步行路线,返回路线总距离、预估用时等信息from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng
directionBicycling规划自行车骑行路线,返回路线总距离、预估用时等信息from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng
directionTransit规划公共交通路线,返回多组乘坐方案及详细信息from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng
futureDrivingDirection根据未来出发时间规划驾车路线,考虑预测路况,返回预估用时、总距离等信息departure_time(必填,出发时间,时间戳格式),from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng
waypointOrder对途经点进行最顺路排序并规划驾车路线,支持最多 16 个途经点from(必填,起点经纬度,格式 lat,lng),to(必填,终点经纬度,格式 lat,lng),waypoints(选填,途经点经纬度,最多 16 个,格式 lat1,lng1;lat2,lng2...),need_waypoint_order(选填,是否需要对途经点排序,值为 truefalse

🔌 使用方式

云开发 MCP 控制台