amap-mcp-server
MCP-сервер карт Amap (高德地图): геокодирование, маршруты пешком, на велосипеде, авто и транспорте, поиск мест и погода.
- 133 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Адреса и координаты из запросов агента отправляются в API Amap по вашему ключу.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/amap-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Адреса и координаты из запросов агента отправляются в API Amap по вашему ключу.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
amap-mcp-server обращается к API китайского картографического сервиса 高德地图 (Amap, Gaode Maps). Агент получает инструменты геокодирования (`maps_geo`, `maps_regeocode`), определения места по IP, погоды по городу или коду adcode, маршрутов пешком (до 100 км), на велосипеде (до 500 км), на машине и общественным транспортом, причем маршруты строятся по координатам или по адресу. Есть измерение расстояния (`maps_distance`), поиск мест по ключевому слову и вокруг точки (`maps_text_search`, `maps_around_search`) и карточка места по ID (`maps_search_detail`). Сервер опубликован в PyPI и запускается через `uvx amap-mcp-server` по stdio (по умолчанию), SSE или streamable HTTP. Ключ API из открытой платформы Amap передается переменной `AMAP_MAPS_API_KEY`.
Для кого. Путешественникам, аналитикам локаций и разработчикам китайских сервисов, которым агент нужен для маршрутов и поиска мест в Китае.
Подходит, если
- Агент планирует поездку по Пекину и строит маршрут между двумя адресами.
- Список адресов переводят в координаты через `maps_geo`.
- Перед выездом проверяют погоду по городу или коду adcode.
- Кафе или станции ищут в радиусе 1000 метров от точки через `maps_around_search`.
Не подходит, если
- Нужны карты российских городов: для них есть сервер Яндекс Карт.
- Ключ Amap недоступен: без `AMAP_MAPS_API_KEY` инструменты не отвечают.
- Требуется работа без сети: сервер обращается к API Amap.
Пример запроса к агенту
Построй маршрут на общественном транспорте от Пекинского вокзала до Летнего дворца и покажи время в пути.MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
Переменные окружения
AMAP_MAPS_API_KEYобязательная, секрет- Ключ API открытой платформы Amap для запросов к картографическим сервисам.
Ограничения
Нужен ключ `AMAP_MAPS_API_KEY`, его получают в открытой платформе Amap (lbs.amap.com) после регистрации. Тексты инструментов и примеры адресов в README китайские: адреса передают так, как их пишут на карте Amap. Маршрут пешком ограничен 100 км, на велосипеде 500 км. Запросы уходят в API Amap, поэтому адреса и координаты видит сервис. При запуске по SSE или streamable HTTP сервер слушает `0.0.0.0:8000`, снаружи локальной сети порт стоит закрыть.
Как отключить. Удалите сервер `amap-mcp-server` из конфигурации MCP-клиента и остановите процесс, если запускали HTTP или SSE. Ключ API отзовите в кабинете Amap.
Частые вопросы
Как подключить amap-mcp-server?
Добавьте в конфигурацию клиента сервер с командой `uvx` и аргументом `amap-mcp-server`, а в `env` укажите `AMAP_MAPS_API_KEY`. Транспорт по умолчанию — stdio.
Как запустить сервер по SSE или HTTP?
Задайте `AMAP_MAPS_API_KEY` в окружении и выполните `uvx amap-mcp-server sse` или `uvx amap-mcp-server streamable-http`. Клиент подключается к `http://0.0.0.0:8000/sse` или `/mcp`.
Где взять ключ API?
Зарегистрируйтесь на открытой платформе Amap (lbs.amap.com) и создайте ключ для веб-сервисов.
Что выбрать для маршрута: координаты или адрес?
Предпочтительны версии «по адресу», например `maps_direction_walking_by_address`. Для кросс-городского транспорта обязательно указывают города отправления и прибытия.
Какие виды маршрутов строит сервер?
Пешком, на велосипеде, на машине и общественным транспортом, по координатам или по адресу. Есть еще `maps_distance` для расстояния между точками.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для почты по протоколу JMAP: поиск, чтение, пометки, перенос и отправка писем в Fastmail и Stalwart из агента
MCP-сервер для Kaiten
mcp_server_for_kaiten
Простой MCP-сервер на Python для CRUD-операций с пространствами, досками и картами Kaiten
Weather API MCP Server — текущая погода по городу
Weather API MCP Server
MCP погода на Go: инструмент current_weather отдает агенту текущую погоду по названию города из сервиса WeatherAPI, запуск локально или в Docker
Plane MCP Server — управление проектами Plane
Plane MCP Server
Официальный MCP-сервер Plane: агент ведет проекты, задачи, циклы и релизы через 30 инструментов
Strava MCP
Strava MCP Server
MCP-сервер Strava: агент читает ваши тренировки, пульс, ватты, сегменты и маршруты и выгружает маршруты в GPX и TCX
Официальный MCP сервер Anytype: агент ищет, создает и меняет объекты, списки и типы в вашей базе знаний
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| amap-mcp-server (эта карточка) | нет | API-ключ | 133 | |
| Yandex Maps MCP Server | нет | API-ключ | 17 | работает с Яндекс Картами: геокодирование и статическая карта; amap-mcp-server добавляет маршруты, погоду и поиск мест на данных Amap |
| Google Maps MCP | нет | API-ключ | 489 | читает данные Google Maps Platform; amap-mcp-server обращается к китайскому сервису Amap |
Коротко о README
README перечисляет инструменты по группам (геокодирование, местоположение и погода, маршруты, расстояния, поиск мест) с параметрами каждого и описывает три транспорта: stdio, SSE и streamable HTTP. Для каждого приведен пример конфигурации клиента.