Amap Maps MCP Server

🚀 AMap Map MCP Server

The MCP Server for the AMap Map API, enabling seamless integration with location - based services.

🚀 Quick Start

✨ Features

The AMap Map MCP Server offers the following features:

• Supports multiple location services including geocoding, weather, and distance measurement.
• Provides APIs for various transportation modes including walking, driving, and public transit.
• Allows for detailed searches of points of interest (POIs) based on keywords or location.

📦 Installation

API Key

Get an AMap Maps API key from: https://lbs.amap.com/api/webservice/create-project-and-key.

NPX

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@masx200/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "The key you applied for on the AMap official website"
      }
    }
  }
}

Environment Variables

The configurable environment variables are:

• AMAP_MAPS_API_KEY: AMap Maps API key (Required).
• HTTP_API_TOKEN: HTTP API access token (Optional).
• HTTP_API_PORT: HTTP server port number (Optional, default is 3000).

Streamable - HTTP Protocol Server

In addition to running as an MCP server, this project also supports starting an independent streamable - http protocol server:

Direct Startup

node ./build/streamable-http.js

Configuration with Environment Variables

# Set the port (default is 3000)
export HTTP_API_PORT=3000

# Set the access token (Optional)
export HTTP_API_TOKEN=your-secret-token

# Set the AMap Maps API key
export AMAP_MAPS_API_KEY=your-amap-api-key

# Start the server
node ./build/streamable-http.js

💻 Usage Examples

Basic Usage

After starting the server, it will run at http://localhost:3000 and support the following endpoints:

• POST /mcp - MCP protocol communication endpoint
• Real - time data streams supporting the streamable - http protocol

If HTTP_API_TOKEN is set, please add the following to the request header:

Authorization: Bearer your-secret-token

📚 Documentation

What is Amap Maps?

Amap Maps is a server that supports any MCP protocol client, allowing users to easily utilize the Amap Maps MCP server for various location - based services.

How to use Amap Maps?

To use Amap Maps, configure it in a compatible client like Cursor by copying your API key and setting up the server command as specified in the documentation.

Use cases of Amap Maps?

• Converting geographic coordinates to administrative addresses.
• Planning routes for cycling, walking, or driving.
• Searching for nearby points of interest based on user - defined criteria.

FAQ from Amap Maps?

What types of location services does Amap Maps provide?

Amap Maps provides geocoding, weather information, distance measurement, and route planning for various transportation modes.

Is there a limit to the number of requests I can make?

The usage limits depend on the API key and the specific service being used. Please refer to the Amap documentation for details.

How do I obtain an API key?

You can obtain an API key by creating a project on the Amap developer platform.

Configuration in Cursor

It is recommended to use the latest version of the Cursor client.

Access Configuration

Copy the key from: https://lbs.amap.com/api/mcp-server/create-project-and-key

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@masx200/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "The key you applied for on the AMap official website"
      }
    }
  }
}