AMap

Provides access to AMap location services via MCP clients using a local stdio server and an AMap API key.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "francis235-amap-mcp": {
      "command": "uvx",
      "args": [
        "amap-mcp"
      ],
      "env": {
        "AMAP_KEY": "<insert-your-AMap-here>"
      }
    }
  }
}

This MCP server lets you interact with AMap’s powerful location services from MCP clients by exposing a simple, consistent protocol. You can perform location-related queries and actions through compatible clients such as Cursor, Claude Desktop, Cline, Windsurf, and others, without writing bespoke integration code for each client.

How to use

To use this MCP server with a client, you configure a global MCP entry in your client’s MCP settings. The server runs locally via the Python package manager you install, and you provide your AMap key so the service can authenticate requests to AMap.

How to install

Prerequisites you need before installing the MCP server.

# Install Python 3.10+ from the official source for your platform
# Ensure you have Python 3.10 or newer installed

# Install the uv tool (Python package manager) which provides uvx
pip install uv

# Obtain your AMap key from the AMAP Open Platform and prepare to configure the server
AMAP_KEY=YOUR_AMAP_KEY

# Create or update your MCP client configuration to include the AMap MCP server
# The following snippet is what you paste into your mcp.json in Cursor settings
"AMap": {
  "command": "uvx",
  "args": [
    "amap-mcp"
  ],
  "env": {
    "AMAP_KEY": "<insert-your-AMap-here>"
  },
},

# Start from the client side: in Cursor (or your MCP client), add a new global MCP server and paste the above config when prompted

Additional content

Notes and guidance for getting the most out of this MCP server:
- The AMap key you supply authenticates requests to AMap services.
- Use the provided configuration in your MCP client to ensure the server starts with the correct environment.
- If you encounter issues, verify that Python 3.10+ is installed and that uv is installed correctly with pip. Ensure the AMAP_KEY value is set and not left blank.