Python版本高德地图MCP Server

Python版本高德地图MCP Server

site icon
2025.04.20 2
Python地图服务位置服务位置服务
amap-mcp-server 是一个基于高德地图API的Python服务,提供了一系列与地图和位置相关的功能。该服务能够处理地理编码、逆地理编码、IP定位、天气查询、路径规划(骑行、步行、驾车、公共交通)、距离测量以及POI搜索等多种地图相关操作。适用于需要集成高德地图功能的开发者,支持多种场景下的位置服务需求。
View on GitHub

Overview

基本能力

产品定位

amap-mcp-server 是一个基于高德地图API的Python服务,旨在为开发者提供丰富的地图和位置服务功能。

核心功能

  1. 地理编码与逆地理编码:将地址转换为经纬度坐标,或将经纬度坐标转换为地址信息。
  2. IP定位:根据IP地址定位用户所在位置。
  3. 天气查询:根据城市名称或adcode查询天气信息。
  4. 路径规划:支持骑行、步行、驾车和公共交通等多种路径规划方式。
  5. 距离测量:测量两个经纬度坐标之间的距离。
  6. POI搜索:支持关键词搜索、周边搜索和POI详情查询。

适用场景

  1. 地理编码与逆地理编码:适用于需要将地址转换为坐标或反之的应用场景。
  2. IP定位:适用于需要根据用户IP地址提供个性化服务的场景。
  3. 天气查询:适用于需要显示城市天气信息的应用。
  4. 路径规划:适用于导航、出行规划等场景。
  5. 距离测量:适用于需要计算两点之间距离的应用。
  6. POI搜索:适用于需要搜索地点或周边信息的应用。

工具列表

  1. maps_regeocode:将经纬度坐标转换为行政区划地址信息。
  2. maps_geo:将结构化地址转换为经纬度坐标。
  3. maps_ip_location:根据IP地址定位位置。
  4. maps_weather:查询城市天气信息。
  5. maps_bicycling:骑行路径规划。
  6. maps_direction_walking:步行路径规划。
  7. maps_direction_driving:驾车路径规划。
  8. maps_direction_transit_integrated:公共交通路径规划。
  9. maps_distance:测量两点之间的距离。
  10. maps_text_search:关键词搜索POI。
  11. maps_around_search:周边搜索POI。
  12. maps_search_detail:查询POI详细信息。

常见问题解答

  1. 如何获取高德地图API密钥? 需要在高德开放平台注册并申请API密钥。
  2. 服务支持哪些路径规划方式? 支持骑行、步行、驾车和公共交通等多种方式。
  3. 如何限制POI搜索范围? 可以通过citylimit参数限制搜索范围。

使用教程

使用依赖

  1. 安装Python 3.6及以上版本。
  2. 安装依赖库: bash pip install requests

安装教程

  1. 克隆项目仓库: bash git clone https://github.com/zxypro1/amap-maps-mcp-server.git
  2. 进入项目目录: bash cd amap-maps-mcp-server
  3. 安装依赖: bash pip install -r requirements.txt

调试方式

  1. 启动服务: bash python server.py
  2. 使用Postman或curl测试API接口。 bash curl "http://localhost:5000/maps_geo?address=北京市海淀区"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。