mcpField
A
amap-maps

amap-maps

github.com/zkl2333Other149 installsUpdated 20w ago
Repository

About amap-maps

amap-maps is a skill for calling Amap Web Service API through its MCP server. It supports location lookup, weather, POI search, route planning, and distance measurement for applications using Amap services.

Key features

  1. 01Geocode addresses and coordinates
  2. 02Locate an IP address
  3. 03Retrieve city weather
  4. 04Search and inspect POIs
  5. 05Plan driving, walking, and cycling routes
  6. 06Measure distances

Use cases

  1. 01Find coordinates for an address
  2. 02Search nearby places in a city
  3. 03Retrieve weather for a city
  4. 04Plan a route between coordinates

MCP support

The skill calls the amap-maps MCP server, which exposes Amap Web Service API tools to MCP clients. It requires an Amap Web Service API key.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zkl2333/skills --skill amap-maps

After installing, type/amap-mapsin Claude Code to confirm it loaded.

Details

From the project 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 限制，避免短时间大量请求

Comments

Markdown supported