Amap

You deploy the Amap MCP Server to expose a rich set of map and routing services to MCP clients. It enables geocoding, location, weather, directions, distance measurement, and POI search, all accessible via MCP transports like stdio, SSE, or streamable HTTP.

How to use

You use an MCP client to connect to the Amap MCP Server. Choose a transport method supported by the server and configure the client to reach the server endpoint. The server exposes a comprehensive set of geographic tools and routing services that you can invoke through MCP calls, enabling centralized access to maps, places, and routes.

How to install

Prerequisites: You need a running Python environment with access to install packages, and you should obtain an API key from the Amap developer portal.

1. Install the MCP server package in your environment using your preferred method. 2) Prepare the API key for authentication and testing.

Install and start the server locally using the stdio transport as shown below. This configuration runs the MCP server so a local client can connect via stdio.

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

Additional configuration options

If you prefer to use streaming or SSE for real-time MCP communication, you can run the server in SSE mode and connect your client to the SSE endpoint.

Alternatively, you can use Streamable HTTP to run the server and connect through a standard HTTP-based MCP transport.

# SSE run (local example)
export AMAP_MAPS_API_KEY=your_valid_api_key
uvx amap-mcp-server sse

Notes on endpoints and client configuration

The following client configurations illustrate how to connect to the MCP server using different transports. Use the endpoint that matches your deployment scenario.

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

Security and API keys

Securely store your Amap API key and do not expose it in client configurations or logs. Use environment variables or secret management in your deployment to inject the key at runtime.

Tools and capabilities at a glance

The server provides a wide range of tools for geographic data and routing tasks, including geocoding, address parsing, IP location, weather queries, and multiple routing modes such as walking, bicycling, driving, and transit. It also supports distance measurement and POI search.

Available tools

maps_regeocode

Geocodes a given longitude and latitude into administrative district information.

maps_geo

Converts a structured address to geographic coordinates, supporting landmark and building lookups.

maps_ip_location

Locates a place by resolving the provided IP address.

maps_weather

Queries the weather for a specified city or adcode.

maps_bicycling_by_coordinates

Plans a bicycling route between coordinates, considering bridges, one-way streets, and closures, up to 500 km.

maps_bicycling_by_address

Bicycling route planning using addresses for origin and destination.

maps_direction_walking_by_coordinates

Walk routing between coordinates within 100 km.

maps_direction_walking_by_address

Walk routing using origin and destination addresses.

maps_direction_driving_by_coordinates

Driving route planning between coordinates for cars.

maps_direction_driving_by_address

Driving route planning using addresses.

maps_direction_transit_integrated_by_coordinates

Integrated public transit routing between coordinates across trains, buses, and subways; cross-city requires origin and destination cities.

maps_direction_transit_integrated_by_address

Integrated public transit routing using addresses; cross-city requires origin and destination cities.

maps_distance

Measures distance between two coordinates, supporting driving, walking, and great-circle calculations.

maps_text_search

Keyword-based POI search returning relevant results.

maps_around_search

Nearby POI search around a center point with optional radius and keywords.

maps_search_detail

Fetches detailed information for a POI by its ID.