关于 amap-maps
amap-maps 是通过 MCP 服务调用高德 Web Service API 的技能,提供地点查询、天气、POI 搜索、路线规划和距离测量,适用于使用高德服务的应用。
主要功能
- 01地址与坐标间的地理编码
- 02IP 定位
- 03查询城市天气
- 04搜索和查看 POI
- 05规划驾车、步行和骑行路线
- 06测量距离
适用场景
- 01查询地址对应的坐标
- 02搜索城市周边地点
- 03查询城市天气
- 04规划坐标间的路线
MCP 相关
该技能调用 amap-maps MCP 服务,由其向 MCP 客户端提供高德 Web Service API 工具。使用时需要高德 Web Service API Key。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ zkl2333/ skills --skill amap-maps安装后在 Claude Code 中输入/amap-maps确认已加载。
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
高德地图 Skill
通过 MCP server (amap-maps) 调用高德 Web Service API。
前置条件
-
在你的
mcporter.json里加入 server 配置(合并到mcpServers下即可):"amap-maps": { "command": "npx", "args": ["-y", "@amap/amap-maps-mcp-server"], "env": { "AMAP_MAPS_API_KEY": "YOUR_AMAP_API_KEY" } } -
需要高德 Web Service API Key(环境变量
AMAP_MAPS_API_KEY)
可用工具
所有工具通过 mcporter call amap-maps.<tool> 调用。
地理编码
# 地址 → 坐标
mcporter call amap-maps.maps_geo address="杭州市萧山区"
# 坐标 → 地址(逆地理编码)
mcporter call amap-maps.maps_regeocode location="120.26,30.27"
IP 定位
mcporter call amap-maps.maps_ip_location ip="114.247.50.2"
天气
mcporter call amap-maps.maps_weather city="杭州"
POI 搜索
# 关键词搜索
mcporter call amap-maps.maps_search_text keywords="咖啡" city="杭州"
# 周边搜索
mcporter call amap-maps.maps_search_around keywords="餐厅" location="120.26,30.27"
# POI 详情
mcporter call amap-maps.maps_search_detail id="B0FFH3V5BN"
路线规划
# 驾车
mcporter call amap-maps.maps_direction_driving origin="120.26,30.27" destination="121.47,31.23"
# 步行
mcporter call amap-maps.maps_direction_walking origin="120.26,30.27" destination="120.28,30.29"
# 骑行
mcporter call amap-maps.maps_bicycling origin="120.26,30.27" destination="120.28,30.29"
# 公交(跨城需传 city/cityd)
mcporter call amap-maps.maps_direction_transit_integrated origin="120.26,30.27" destination="121.47,31.23" city="杭州" cityd="上海"
距离测量
mcporter call amap-maps.maps_distance origins="120.26,30.27" destination="121.47,31.23"
坐标格式
高德使用 GCJ-02 坐标系,格式为 经度,纬度(注意:经度在前)。
使用建议
- 需要坐标时先用
maps_geo把地址转成经纬度 - 配合
caiyun-weatherskill 使用:先用高德 geocoding 获取坐标,再传给彩云天气 - 高德 API 有 QPS 限制,避免短时间大量请求
评论
支持 Markdown