2GIS MCP

2GIS MCP (mapgl-mcp-server)

Официальный MCP-сервер 2ГИС: поиск мест, геокодирование, маршруты, изохроны и статичные карты через API 2ГИС, нужен ключ из Менеджера Платформы

  • 6 ★ репозитория
  • Последний коммит
MCP-серверОфициальныйВыбор редакции

Расширенный доступ

Почему такой уровень

  • Локальный сервер обращается к API 2ГИС: поиск мест, маршруты, геокодирование
  • Расходует квоту ключей MAPGL_API_KEY и ROUTING_API_KEY, данные только читает
Все причины и проверки
Российский стек

2gis/2gis-mcp

Установка

Сервисы

Ручная установка

git clone https://github.com/2gis/2gis-mcp.git && cd 2gis-mcp && npm install && npm run build

Пакет не опубликован в npm, сборка из исходников по package.json репозитория.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Локальный сервер обращается к API 2ГИС: поиск мест, маршруты, геокодирование
  • Расходует квоту ключей MAPGL_API_KEY и ROUTING_API_KEY, данные только читает

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает агенту шесть инструментов поверх API 2ГИС. search_poi ищет места и организации по запросу рядом с точкой (Places API и Geocoder API), calculate_route строит маршрут для разных видов транспорта со временем и расстоянием (Routing API), geocode и reverse_geocode переводят адрес в координаты и обратно (Geocoder API), create_map_view рисует статичную PNG-карту с маркерами, линиями и полигонами (Static API), calculate_isochrone строит зону, достижимую от точки за заданное время (Isochrone API). Ключ для карт и поиска передается в MAPGL_API_KEY, ключ для маршрутов и изохрон в ROUTING_API_KEY, при одном общем ключе его указывают в обеих переменных.

Для кого. Для разработчиков и аналитиков, которым нужны карты, поиск мест и маршруты 2ГИС по городам России и СНГ прямо в агенте.

Подходит, если

  • Нужно найти организации нужного типа рядом с точкой на карте
  • Нужно построить маршрут между адресами или координатами
  • Нужно попробовать API 2ГИС из агента на бесплатном демо-ключе

Не подходит, если

  • Не хочется собирать сервер из исходников: у 2ГИС есть облачный MCP-сервер по адресу mcp-2gis.api.2gis.com/mcp
  • Нужна постоянная нагрузка без подписки: демо-ключ действует 30 дней и ограничен по числу запросов

Пример запроса к агенту

Найди кофейни в радиусе 500 метров от Красной площади и построй маршрут пешком до ближайшей

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

MAPGL_API_KEY обязательная, секрет
Ключ API 2ГИС для карт и поиска: Places API, Geocoder API, Static API.
ROUTING_API_KEY секрет
Ключ API 2ГИС для навигации: Routing API и Isochrone API, можно указать тот же ключ.

Ограничения

Пакет не опубликован в npm, сервер ставят клонированием репозитория и сборкой через npm run build. README в репозитории короткий, инструменты, ключи и подключение к агентам описаны в документации docs.2gis.com. Нужен ключ из личного кабинета Менеджер Платформы: бесплатный демо-ключ действует 30 дней и ограничен по числу запросов, дальше нужна подписка, тарифы те же, что при прямых запросах к API 2ГИС. Код распространяется по проприетарной лицензии 2ГИС. Репозиторий без релизов, 4 ★ репозитория на 04.10.2026.

Как отключить. Удалите блок сервера из конфигурации MCP клиента и остановите процесс node.

Частые вопросы

Где взять ключ?

Зарегистрируйтесь в личном кабинете Менеджер Платформы 2ГИС и оформите бесплатный демо-ключ на 30 дней, в нем уже подключены все API для MCP-сервера. Для постоянной работы нужна подписка.

Почему маршруты не строятся?

calculate_route и calculate_isochrone берут ключ из ROUTING_API_KEY. Если у вас один ключ на все API, укажите его и в MAPGL_API_KEY, и в ROUTING_API_KEY.

Обсуждение

Вопросов и отзывов пока нет.

2GIS MCP

@theyahia/2gis-mcp

Российский стек

MCP-сервер для API 2ГИС: поиск мест, геокодирование, маршруты, общественный транспорт, подсказки адресов и рейтинги

MCP-серверРасширенный доступ4Звезды репозитория
Российский стек

Community MCP-сервер поверх поискового API 2ГИС: места, геокодер, подсказки, категории и регионы, свой ключ 2ГИС и Docker Compose

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

Небольшой прототип MCP поверх MapGL JS API 2ГИС: дает LLM доступ к картам для запросов вроде сравнения районов по плотности кафе

MCP-серверРасширенный доступ
Российский стек

Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные

MCP-серверШирокий доступ38Звезды репозитория
Российский стек

Скилл аудита локального SEO для рынка СНГ: карточки в Google Business Profile, Яндекс Бизнесе, Яндекс Картах, 2ГИС и их согласованность

СкиллРасширенный доступ3Звезды репозитория

Коротко о README

README в репозитории состоит из одного абзаца: название, назначение и ссылка на документацию docs.2gis.com. В документации описаны шесть инструментов локального сервера, API 2ГИС за каждым из них, переменные MAPGL_API_KEY и ROUTING_API_KEY и настройка Claude Desktop, Cursor, VS Code и LM Studio. В репозитории лежит проприетарная лицензия 2ГИС на русском и английском.

Бейдж для README

Сообщить о проблеме