amap-mcp-server

MCP.Pizza Chef: sugarforever

Sixteen lookups cover Chinese mapping data from Amap: turning an address into map coordinates and back again, weather by city, place search, nearby search, distance between two points, and cycling, walking, driving and public-transport routes. Everything is read-only, so nothing can be changed or deleted. A free Amap developer key is required and carries daily usage limits. Coverage is mainland China, so do not expect it to plan a route across London.

Other
Web/Research

Use This MCP server To

Work out how long a drive across Beijing will take Find coffee shops within 500 metres of an address Check today's weather for a Chinese city Turn a street address into map coordinates Compare walking and public-transport routes for the same trip Look up the opening details of a place I found

README

MseeP.ai Security Assessment Badge

高德地图 MCP Server

该高德地图 MCP Server 发布在 PyPI

高德地图 MCP server

MCP 工具列表

本服务提供以下工具:

地理编码工具

maps_regeocode

将一个高德经纬度坐标转换为行政区划地址信息

参数:

  • location: 经纬度坐标
maps_geo

将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标

参数:

  • address: 结构化地址
  • city (可选): 指定查询的城市

位置服务工具

maps_ip_location

IP 定位根据用户输入的 IP 地址,定位 IP 的所在位置

参数:

  • ip: IP地址
maps_weather

根据城市名称或者标准adcode查询指定城市的天气

参数:

  • city: 城市名称或者adcode

路线规划工具

骑行路线
maps_bicycling_by_coordinates

骑行路径规划用于规划骑行通勤方案,规划时会考虑天桥、单行线、封路等情况。最大支持 500km 的骑行路线规划

参数:

  • origin: 起点经纬度坐标
  • destination: 终点经纬度坐标
maps_bicycling_by_address

骑行路径规划(地址版),使用地址进行骑行路线规划,推荐优先使用此工具

参数:

  • origin_address: 起点地址(例如:"北京市朝阳区阜通东大街6号")
  • destination_address: 终点地址(例如:"北京市海淀区上地十街10号")
  • origin_city (可选): 起点所在城市,用于提高地理编码准确性
  • destination_city (可选): 终点所在城市,用于提高地理编码准确性
步行路线
maps_direction_walking_by_coordinates

步行路径规划 API 可以根据输入起点终点经纬度坐标规划100km 以内的步行通勤方案,并且返回通勤方案的数据

参数:

  • origin: 起点经纬度坐标
  • destination: 终点经纬度坐标
maps_direction_walking_by_address

步行路径规划(地址版),使用地址进行步行路线规划,推荐优先使用此工具

参数:

  • origin_address: 起点地址(例如:"北京市朝阳区阜通东大街6号")
  • destination_address: 终点地址(例如:"北京市海淀区上地十街10号")
  • origin_city (可选): 起点所在城市,用于提高地理编码准确性
  • destination_city (可选): 终点所在城市,用于提高地理编码准确性
驾车路线
maps_direction_driving_by_coordinates

驾车路径规划 API 可以根据用户起终点经纬度坐标规划以小客车、轿车通勤出行的方案,并且返回通勤方案的数据

参数:

  • origin: 起点经纬度坐标
  • destination: 终点经纬度坐标
maps_direction_driving_by_address

驾车路径规划(地址版),使用地址进行驾车路线规划,推荐优先使用此工具

参数:

  • origin_address: 起点地址(例如:"北京市朝阳区阜通东大街6号")
  • destination_address: 终点地址(例如:"北京市海淀区上地十街10号")
  • origin_city (可选): 起点所在城市,用于提高地理编码准确性
  • destination_city (可选): 终点所在城市,用于提高地理编码准确性
公共交通路线
maps_direction_transit_integrated_by_coordinates

根据用户起终点经纬度坐标规划综合各类公共(火车、公交、地铁)交通方式的通勤方案,并且返回通勤方案的数据,跨城场景下必须传起点城市与终点城市

参数:

  • origin: 起点经纬度坐标
  • destination: 终点经纬度坐标
  • city: 起点城市
  • cityd: 终点城市
maps_direction_transit_integrated_by_address

公共交通路径规划(地址版),使用地址进行公共交通路线规划,推荐优先使用此工具

参数:

  • origin_address: 起点地址(例如:"北京市朝阳区阜通东大街6号")
  • destination_address: 终点地址(例如:"北京市海淀区上地十街10号")
  • origin_city: 起点所在城市(跨城交通必需)
  • destination_city: 终点所在城市(跨城交通必需)

距离测量工具

maps_distance

测量两个经纬度坐标之间的距离,支持驾车、步行以及球面距离测量

参数:

  • origins: 起点经纬度坐标
  • destination: 终点经纬度坐标
  • type (可选,默认为"1"): 测量类型

POI搜索工具

maps_text_search

关键词搜索 API 根据用户输入的关键字进行 POI 搜索,并返回相关的信息

参数:

  • keywords: 搜索关键词
  • city (可选): 查询城市
  • citylimit (可选,默认为"false"): 是否限制城市范围内搜索
maps_around_search

周边搜,根据用户传入关键词以及坐标location,搜索出radius半径范围的POI

参数:

  • location: 中心点经纬度坐标
  • radius (可选,默认为"1000"): 搜索半径
  • keywords (可选): 搜索关键词
maps_search_detail

查询关键词搜或者周边搜获取到的POI ID的详细信息

参数:

  • id: POI ID

配置方法

要使用此服务,您需要在应用中添加以下MCP配置。服务支持三种传输方式:stdio(默认)、ssestreamable-http

stdio 传输(默认)

直接在客户端配置如下MCP Server即可。

{
    "mcpServers": {
        "amap-mcp-server": {
            "command": "uvx",
            "args": [
                "amap-mcp-server"
            ],
            "env": {
                "AMAP_MAPS_API_KEY": "your valid amap maps api key"
            }
        }
    }
}

SSE 传输

SSE传输支持实时数据推送,适合远程部署MCP Server。

本地以SSE运行 amap-mcp-server

$ export AMAP_MAPS_API_KEY=你的有效API Key
$ uvx amap-mcp-server sse

INFO:     Started server process [50125]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

MCP客户端配置:

{
    "mcpServers": {
        "amap-mcp-server": {
            "url": "http://0.0.0.0:8000/sse"
        }
    }
}

Streamable HTTP 传输

本地以Streamable HTTP运行 amap-mcp-server

$ export AMAP_MAPS_API_KEY=你的有效API Key
$ uvx amap-mcp-server streamable-http

INFO:     Started server process [50227]
INFO:     Waiting for application startup.
StreamableHTTP session manager started
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

MCP客户端配置:

{
    "mcpServers": {
        "amap-mcp-server": {
            "url": "http://localhost:8000/mcp"
        }
    }
}

您可以在高德开放平台注册并获取API密钥。

amap-mcp-server FAQ

Do I need an account key?
Yes — a free Amap developer key from their open platform. The server refuses to start without one, and free keys come with a daily request limit you can exhaust.
Does it work outside China?
Not usefully. Amap is a Chinese mapping service, so addresses, place search, routes and weather are built around mainland China. Elsewhere you will mostly get empty or wrong answers.
Can it change or delete anything?
No. All sixteen tools only look information up, so the worst it can do is use up your daily quota or return a wrong answer.
Is it safe to run the shared network version?
Be careful. In the two networked modes it accepts connections from every network your computer is on, with no password of any kind, so anyone on the same wifi could spend your daily quota. The plain default mode, which runs only for your own app, is the safer choice.
Can I use this to plan my commute?
Yes, if you commute in a Chinese city. Ask for the journey by address and it will compare driving, walking, cycling and public transport for you.
How hard is setup?
Easy. Install the uv tool once, then paste a few lines of settings with your key into your assistant's config file and restart it.
Which apps does it work in?
Any assistant that accepts a small settings snippet, such as Claude Desktop, Cursor or Cline. The project's own notes are written in Chinese, which is worth knowing before you start.