腾讯位置服务 MCP 接入
在AI应用场景中，与真实世界取得连接，进行个性化推荐（推荐餐厅、酒店、活动、景区等），行程规划，获取实时出行信息等，让AI服务于人们现实生活，是很多企业与开发者迫切希望实现的。
对此腾讯位置服务推出基于MCP协议的位置服务开发接口，助开发者们快速实现基于地理位置的AI服务。
环境变量
创建APIKey 腾讯位置服务MCP 依赖WebServiceAPI构建，因此需要先创建key，并开启WebServiceAPI功能，取得相关接口调用配额后方可使用，
具体方法可参见： https://lbs.qq.com/service/webService/webServiceGuide/overview
- 需要将 API_KEY 环境变量配置为您在腾讯位置服务创建的 API Key。
- 配置 JSON_FORMAT： 需要返回 JSON 结构化数据则设置为 1 ，否则设置为0（返回格式化的文本段）
使用说明
腾讯位置服务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（必填，通行方式：driving、walking、bicycling） |
reverseGeocoder | 输入经纬度坐标，返回语义化地址、省市区信息等 | location（必填，经纬度坐标，格式 lat,lng） |
ipLocation | 通过 IP 地址获取当前所在省、市、区信息 | ip（必填，IP 地址，IPv4 或 IPv6） |
weather | 查询行政区划代码对应的城市实时天气或预报天气 | adcode（必填，行政区划代码），type（选填，查询类型：now 或 future，默认为 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（选填，是否需要对途经点排序，值为 true 或 false） |