Skip to main content
Glama

amap-maps-mcp

高德地图 Web Service API 的 MCP Server。

相比官方包的主要改进:

  • 路径规划全部使用路径规划 2.0(v5 接口)

  • 驾车规划支持完整参数:strategy(16 种算路策略)、waypoints(途经点)、plate(车牌限行规避)、avoidpolygons(避让区域)、show_fields 等

  • 公交规划支持:strategy、nightflag、date/time 等

  • POI 搜索支持分页、types、citylimit 参数(官方包的 types 参数实际无效)

工具列表

工具

说明

maps_geo

地理编码(地址 → 坐标)

maps_regeocode

逆地理编码(坐标 → 地址)

maps_ip_location

IP 定位

maps_weather

天气查询

maps_text_search

POI 关键词搜索

maps_around_search

POI 周边搜索

maps_search_detail

POI 详情

maps_direction_driving

驾车路径规划(v5)

maps_direction_walking

步行路径规划(v5)

maps_bicycling

骑行路径规划(v5)

maps_direction_transit_integrated

公共交通路径规划(v5)

maps_distance

距离测量

Related MCP server: Amap MCP Server

前置要求

在高德开放平台申请 Web 服务类型的 API Key。

使用方法

npx(无需安装)

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "amap-maps-mcp"],
      "env": {
        "AMAP_MAPS_API_KEY": "你的APIKey"
      }
    }
  }
}

全局安装

npm install -g amap-maps-mcp
{
  "mcpServers": {
    "amap": {
      "command": "amap-maps-mcp",
      "env": {
        "AMAP_MAPS_API_KEY": "你的APIKey"
      }
    }
  }
}

坐标系说明

高德地图使用 GCJ-02 坐标系。GPS 设备输出的 WGS-84 坐标需要先转换,可使用高德的坐标转换 API。

License

MIT

Available Tools

12 tools
maps_bicyclingA

骑行路径规划(路径规划 2.0,v5 接口)。考虑单行线、封路等。

Inputs: origin (required), destination (required), show_fields, alternative_route.

maps_direction_drivingB

驾车路径规划(路径规划 2.0,v5 接口)。支持途经点、算路策略、车牌限行规避、避让区域等。

Inputs: origin (required), destination (required), ferry, plate, +8 more.

maps_direction_transit_integratedA

公共交通路径规划(路径规划 2.0,v5 接口)。涵盖公交、地铁、火车、跨城交通。

Inputs: city1 (required), origin (required), destination (required), ad1, +10 more.

maps_direction_walkingA

步行路径规划(路径规划 2.0,v5 接口)。支持室内算路、多备选路线。

Inputs: origin (required), destination (required), isindoor, origin_id, +3 more.

maps_distanceB

测量起点到终点的距离(直线距离、驾车距离或步行距离)。

Inputs: origins (required), destination (required), type.

maps_geoC

地理编码:将结构化地址转换为高德经纬度坐标(GCJ-02)。支持中文地址、地标名称。

Inputs: address (required), city.

maps_ip_locationA

根据 IP 地址查询所在城市及大致范围。

Inputs: ip (required).

maps_regeocodeA

逆地理编码:将高德经纬度坐标(GCJ-02)转换为详细结构化地址和行政区划信息。

Inputs: location (required).

maps_search_detailA

根据 POI ID 查询详细信息,包括地址、电话、营业时间、照片等。支持一次传入多个 ID。(搜索POI 2.0,v5接口)

Inputs: id (required), show_fields.

maps_weatherA

查询指定城市未来几天的天气预报。

Inputs: city (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a clearly distinct map function: geocoding, reverse geocoding, weather, POI search by keyword, POI search by radius, POI detail, route planning modes, and distance. Even the similar POI tools are clearly separated by input type and purpose.

    Naming Consistency4/5

    All tools share a consistent maps_ prefix and use readable snake_case names. However, maps_bicycling breaks the maps_direction_* pattern used by the other route tools, and a few names like maps_geo and maps_weather are standalone nouns rather than verb-noun actions.

    Tool Count5/5

    Twelve tools is well-scoped for a map and location server, covering geocoding, POI search, route planning, weather, distance, and IP location. Each tool earns its place and none feel redundant.

    Completeness5/5

    The tool set covers the core map-query workflow end to end: address-to-coordinate, coordinate-to-address, multiple POI search modes, POI detail retrieval, all major route types, and distance measurement. No obvious critical workflow is missing.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables location-based services through AMap/AutoNavi Maps API including geocoding, weather information, route planning, and POI searches. Supports multiple transportation modes and provides detailed geographic data for Chinese locations.
      12
      4
      Mulan Permissive Software , Version 2
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive geographic information services and route planning for AI agents via the Amap (Gaode Maps) API. It supports geocoding, multi-modal navigation, POI searches, and administrative region queries.
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that wraps the Amap (高德地图) Web Service APIs, giving AI assistants like Claude Code 9 map tools: geocoding, route planning (driving/transit/walking/cycling), POI search, nearby search, distance measurement, and IP location.
      12
      34 npm
      1
      MIT