Amap MCP Server

🚀 Gaode Map MCP Server

The Gaode Map MCP Server has been published on PyPI.

🚀 Quick Start

✨ Features

This service offers the following tools:

Geocoding Tools

• maps_regeocode: Converts a Gaode longitude and latitude coordinate into administrative division address information.

  • Parameters:
    • location: Longitude and latitude coordinates.

• maps_geo: Converts a detailed structured address into longitude and latitude coordinates. It supports parsing landmark scenic spots and building names into longitude and latitude coordinates.

  • Parameters:
    • address: Structured address.
    • city (optional): Specifies the city for the query.

Location Service Tools

• maps_ip_location: IP location determines the location of an IP based on the user - input IP address.

  • Parameters:
    • ip: IP address.

• maps_weather: Queries weather information based on the city name or standard code.

  • Parameters:
    • city (optional): Name or standard code of the city to be queried.

Distance Measurement Tools

• maps_distance: Measures the distance between two longitude and latitude coordinates, supporting driving, walking, and spherical distance measurements.
  • Parameters:
    • origins: Longitude and latitude coordinates of the starting point.
    • destination: Longitude and latitude coordinates of the ending point.
    • type (optional, default is "1"): Measurement type.

POI Search Tools

• maps_text_search: The keyword search API performs a POI search based on the user - input keywords and returns relevant information.

  • Parameters:
    • keywords: Search keywords.
    • city (optional): City for the query.
    • citylimit (optional, default is "false"): Whether to limit the search within the city.

• maps_around_search: Performs a surrounding search. Based on the user - input keywords and the coordinate location, it searches for POIs within the radius range.

  • Parameters:
    • location: Longitude and latitude coordinates of the center point.
    • radius (optional, default is "1000"): Search radius.
    • keywords (optional): Search keywords.

• maps_search_detail: Queries the detailed information of the POI ID obtained from the keyword search or surrounding search.

  • Parameters:
    • id: POI ID.

📦 Installation

To use this service, you need to add the following MCP configuration to your application:

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

Add the above configuration to your configuration file and make sure to replace "your valid amap maps api key" with your actual Gaode Map API key. You can register and obtain the API key on the Gaode Open Platform.