
Python版本高德地图MCP Server

2025.04.20
2
Python地图服务位置服务位置服务
amap-mcp-server 是一个基于高德地图API的Python服务,提供了一系列与地图和位置相关的功能。该服务能够处理地理编码、逆地理编码、IP定位、天气查询、路径规划(骑行、步行、驾车、公共交通)、距离测量以及POI搜索等多种地图相关操作。适用于需要集成高德地图功能的开发者,支持多种场景下的位置服务需求。
View on GitHub
Overview
基本能力
产品定位
amap-mcp-server 是一个基于高德地图API的Python服务,旨在为开发者提供丰富的地图和位置服务功能。
核心功能
- 地理编码与逆地理编码:将地址转换为经纬度坐标,或将经纬度坐标转换为地址信息。
- IP定位:根据IP地址定位用户所在位置。
- 天气查询:根据城市名称或adcode查询天气信息。
- 路径规划:支持骑行、步行、驾车和公共交通等多种路径规划方式。
- 距离测量:测量两个经纬度坐标之间的距离。
- POI搜索:支持关键词搜索、周边搜索和POI详情查询。
适用场景
- 地理编码与逆地理编码:适用于需要将地址转换为坐标或反之的应用场景。
- IP定位:适用于需要根据用户IP地址提供个性化服务的场景。
- 天气查询:适用于需要显示城市天气信息的应用。
- 路径规划:适用于导航、出行规划等场景。
- 距离测量:适用于需要计算两点之间距离的应用。
- POI搜索:适用于需要搜索地点或周边信息的应用。
工具列表
- maps_regeocode:将经纬度坐标转换为行政区划地址信息。
- maps_geo:将结构化地址转换为经纬度坐标。
- maps_ip_location:根据IP地址定位位置。
- maps_weather:查询城市天气信息。
- maps_bicycling:骑行路径规划。
- maps_direction_walking:步行路径规划。
- maps_direction_driving:驾车路径规划。
- maps_direction_transit_integrated:公共交通路径规划。
- maps_distance:测量两点之间的距离。
- maps_text_search:关键词搜索POI。
- maps_around_search:周边搜索POI。
- maps_search_detail:查询POI详细信息。
常见问题解答
- 如何获取高德地图API密钥? 需要在高德开放平台注册并申请API密钥。
- 服务支持哪些路径规划方式? 支持骑行、步行、驾车和公共交通等多种方式。
- 如何限制POI搜索范围?
可以通过
citylimit
参数限制搜索范围。
使用教程
使用依赖
- 安装Python 3.6及以上版本。
- 安装依赖库:
bash pip install requests
安装教程
- 克隆项目仓库:
bash git clone https://github.com/zxypro1/amap-maps-mcp-server.git
- 进入项目目录:
bash cd amap-maps-mcp-server
- 安装依赖:
bash pip install -r requirements.txt
调试方式
- 启动服务:
bash python server.py
- 使用Postman或curl测试API接口。
bash curl "http://localhost:5000/maps_geo?address=北京市海淀区"