mcpField
A
amap-maps

amap-maps

github.com/zkl2333其他149 次安装20 周前更新
代码仓库

关于 amap-maps

amap-maps 是通过 MCP 服务调用高德 Web Service API 的技能,提供地点查询、天气、POI 搜索、路线规划和距离测量,适用于使用高德服务的应用。

主要功能

  1. 01地址与坐标间的地理编码
  2. 02IP 定位
  3. 03查询城市天气
  4. 04搜索和查看 POI
  5. 05规划驾车、步行和骑行路线
  6. 06测量距离

适用场景

  1. 01查询地址对应的坐标
  2. 02搜索城市周边地点
  3. 03查询城市天气
  4. 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

来自项目 README

README 暂无中文译文,以下为英文原文;中文介绍见上方。

高德地图 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-weather skill 使用:先用高德 geocoding 获取坐标,再传给彩云天气
  • 高德 API 有 QPS 限制,避免短时间大量请求

评论

支持 Markdown