2GIS MCP
2GIS MCP (mapgl-mcp-server)
Официальный MCP-сервер 2ГИС: поиск мест, геокодирование, маршруты, изохроны и статичные карты через API 2ГИС, нужен ключ из Менеджера Платформы
- 6 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Локальный сервер обращается к API 2ГИС: поиск мест, маршруты, геокодирование
- Расходует квоту ключей MAPGL_API_KEY и ROUTING_API_KEY, данные только читает
Установка
- Работает в
- Сервисы
Ручная установка
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.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
2ГИС — все инструменты2GIS MCP
@theyahia/2gis-mcp
MCP-сервер для API 2ГИС: поиск мест, геокодирование, маршруты, общественный транспорт, подсказки адресов и рейтинги
MCP-сервер поиска 2ГИС
2GIS Search MCP Server
Community MCP-сервер поверх поискового API 2ГИС: места, геокодер, подсказки, категории и регионы, свой ключ 2ГИС и Docker Compose
MapGL MCP Server (прототип)
MapGL MCP Server
Небольшой прототип MCP поверх MapGL JS API 2ГИС: дает LLM доступ к картам для запросов вроде сравнения районов по плотности кафе
Свой MCP-сервер на Cloudflare Workers для локального SEO: поиск и карточки организаций в 2ГИС, Яндекс Геокодере и Google Places
Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные
Скилл локального SEO для Google, Яндекс и 2ГИС
Google Yandex 2GIS Local SEO Skill
Скилл аудита локального SEO для рынка СНГ: карточки в Google Business Profile, Яндекс Бизнесе, Яндекс Картах, 2ГИС и их согласованность
Коротко о README
README в репозитории состоит из одного абзаца: название, назначение и ссылка на документацию docs.2gis.com. В документации описаны шесть инструментов локального сервера, API 2ГИС за каждым из них, переменные MAPGL_API_KEY и ROUTING_API_KEY и настройка Claude Desktop, Cursor, VS Code и LM Studio. В репозитории лежит проприетарная лицензия 2ГИС на русском и английском.