Amap

v1.0.0Search & Data Extractionstable

高德地图MCP Server,支持stdio, sse和streamable-http

mcpamapkotlinmcp-server
Share:
107
Stars
0
Downloads
0
Weekly
0/5

What is Amap?

Amap is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 高德地图mcp server,支持stdio, sse和streamable-http

高德地图MCP Server,支持stdio, sse和streamable-http

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 高德地图MCP Server,支持stdio, sse和streamable-http

Use Cases

Query Amap (Alibaba's mapping service) for location data. Get maps and navigation information for China. Access location-based services.
sugarforever

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx amap

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Amap

The Amap MCP Server connects AI assistants to Gaode (Amap), the leading mapping and location services platform in China operated by Alibaba. It exposes over 13 tools covering geocoding, reverse geocoding, IP geolocation, weather queries, multi-modal route planning (driving, walking, cycling, transit), distance calculation, and POI search. Developers building China-focused applications or needing accurate Chinese address data, navigation routes, and nearby place searches will find this server essential.

Prerequisites

  • Python 3.10 or later and uv package manager installed
  • An Amap API key obtained from https://lbs.amap.com/ (Amap Open Platform)
  • An MCP client such as Claude Desktop
  • Internet access to reach Amap API endpoints
1

Obtain an Amap API key

Register at https://lbs.amap.com/, create an application, and copy your Web Service API key. This key is required for all tool calls.

2

Install uv if not already present

The server is distributed via PyPI and is best run with uvx, which is bundled with the uv package manager.

curl -LsSf https://astral.sh/uv/install.sh | sh
3

Verify the package is available

Test that uvx can locate and run the amap-mcp-server package without errors.

uvx amap-mcp-server --help
4

Configure your MCP client

Add the server to your Claude Desktop config, passing your Amap API key as an environment variable.

// claude_desktop_config.json
{
  "mcpServers": {
    "amap": {
      "command": "uvx",
      "args": ["amap-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your_amap_api_key_here"
      }
    }
  }
}
5

Restart Claude Desktop and test

Quit and reopen Claude Desktop, then ask a location-related question about China to verify the tools are working.

Amap Examples

Client configuration

Claude Desktop stdio config using uvx to run the Amap MCP server

{
  "mcpServers": {
    "amap": {
      "command": "uvx",
      "args": ["amap-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your_amap_api_key_here"
      }
    }
  }
}

Prompts to try

Example natural language prompts that exercise Amap MCP server tools

- "What is the address for coordinates 116.397428, 39.90923?"
- "Find the driving route from the Forbidden City to Shanghai Pudong Airport."
- "What is the current weather in Chengdu?"
- "Search for coffee shops near Zhongguancun, Beijing."
- "How far is it from Guangzhou to Shenzhen by road?"

Troubleshooting Amap

API returns INVALID_USER_KEY error

Double-check that AMAP_MAPS_API_KEY is set to a valid Web Service API key (not a JavaScript or Android key). The key type must match the service type used.

Route planning returns no results for addresses outside China

Amap covers mainland China only. Use WGS-84 coordinates converted to GCJ-02 (China's coordinate system) for accurate results within China.

uvx command not found after installation

Run 'source ~/.bashrc' or open a new terminal to reload the PATH after installing uv. Verify with 'which uvx'.

Frequently Asked Questions about Amap

What is Amap?

Amap is a Model Context Protocol (MCP) server that 高德地图mcp server,支持stdio, sse和streamable-http It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Amap?

Follow the installation instructions on the Amap GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Amap?

Amap works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Amap free to use?

Yes, Amap is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "amap": { "command": "npx", "args": ["-y", "amap"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Amap?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides