Amap MCP Server

Сервер для интеграции с гео-сервисами 高德地图 (Amap) через протокол MCP. Позволяет AI-агентам выполнять геокодирование, поиск POI, построение маршрутов, запрос погоды и IP-локации. Пакет опубликован на PyPI: amap-mcp-server.

Возможности

Сервер предоставляет следующие группы инструментов:

Геокодирование

• maps_regeocode – преобразование координат (долгота, широта) в адрес и административную единицу.

• maps_geo – преобразование структурированного адреса в координаты. Поддерживает достопримечательности и названия зданий.

  Параметры: address (обязательно), city (опционально).

Службы местоположения

• maps_ip_location – определение местоположения по IP-адресу.

• maps_weather – получение погоды по названию города или стандартному коду adcode.

  Параметры: city.

Построение маршрутов

Доступны маршруты для разных видов транспорта, каждый инструмент существует в двух вариантах: по координатам и по адресу (рекомендуемый). Для адресных версий можно указать город отправления/назначения для повышения точности геокодирования.

• Велосипед – maps_bicycling_by_coordinates, maps_bicycling_by_address. Максимальная длина маршрута – 500 км.
• Пешком – maps_direction_walking_by_coordinates, maps_direction_walking_by_address. До 100 км.
• Автомобиль – maps_direction_driving_by_coordinates, maps_direction_driving_by_address. Для легковых авто.
• Общественный транспорт – maps_direction_transit_integrated_by_coordinates, maps_direction_transit_integrated_by_address. Включает поезда, автобусы, метро. Для межгородских маршрутов обязательны параметры city и cityd (или origin_city / destination_city).

Измерение расстояний

• maps_distance – расстояние между двумя координатами. Поддерживаются режимы: автомобиль, пешком и сферическое расстояние.

  Параметры: origins, destination, type (опционально, по умолчанию "1").

Поиск POI

• maps_text_search – поиск объектов по ключевым словам. Опционально: city, citylimit.
• maps_around_search – поиск объектов в радиусе вокруг заданной точки (location, radius, keywords).
• maps_search_detail – получение детальной информации об объекте по его POI ID.

Установка и настройка

Для работы требуется API-ключ, который можно получить на 开放平台 Amap.

Через stdio (рекомендуется для локального использования)

Добавьте в конфигурацию MCP-клиента:

{
  "mcpServers": {
    "amap-mcp-server": {
      "command": "uvx",
      "args": ["amap-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "ваш API-ключ"
      }
    }
  }
}

Через SSE (подходит для удалённого сервера)

Запустите сервер:

export AMAP_MAPS_API_KEY=ваш API-ключ
uvx amap-mcp-server sse

Сервер будет доступен по http://0.0.0.0:8000/sse.

Конфигурация клиента:

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

Через Streamable HTTP

Запуск:

export AMAP_MAPS_API_KEY=ваш API-ключ
uvx amap-mcp-server streamable-http

Сервер доступен по http://localhost:8000/mcp.

Конфигурация:

{
  "mcpServers": {
    "amap-mcp-server": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Примечания

• Для маршрутов на общественном транспорте между городами обязательно указывать оба города.
• При использовании адресных версий маршрутов рекомендуется передавать origin_city и destination_city – это повышает точность геокодирования.
• Длина веломаршрута ограничена 500 км, пешего – 100 км.
• Для поиска POI с параметром citylimit=true результаты будут ограничены указанным городом.