2GIS MCP
@theyahia/2gis-mcp
MCP-сервер для API 2ГИС: поиск мест, геокодирование, маршруты, общественный транспорт, подсказки адресов и рейтинги
- 4 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ходит во внешний API 2ГИС и расходует квоту ключа
- Часть данных берется из недокументированного метода
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/theyahia-2gis-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ходит во внешний API 2ГИС и расходует квоту ключа
- Часть данных берется из недокументированного метода
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту девять инструментов 2ГИС, все только на чтение. Можно искать места и организации рядом с точкой, по рубрике или по запросу, получать карточку места по ID, переводить адрес в координаты и обратно. Маршруты строятся для машины, пешком, на велосипеде, такси, самокате и отдельно на общественном транспорте. Для отзывов сервер всегда возвращает рейтинг и число отзывов, а тексты пытается получить через недокументированный метод. Покрытие: Россия, СНГ и другие регионы 2ГИС.
Для кого. Разработчикам, аналитикам и маркетологам, которым нужны гео-данные и организации в городах России и СНГ.
Подходит, если
- Нужно найти организации нужной категории рядом с адресом
- Нужно геокодировать список адресов или определить адрес по координатам
- Нужно сравнить время в пути на машине и общественном транспорте
Не подходит, если
- Нужны тексты отзывов как надежный источник: их получение неофициальное
- Нужны карты за пределами покрытия 2ГИС
Пример запроса к агенту
Найди аптеки в радиусе километра от площади Ленина в Новосибирске и построй пешеходный маршрут до ближайшейMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
TWOGIS_API_KEYобязательная, секрет- API-ключ 2ГИС с dev.2gis.com
TWOGIS_TIMEOUT_MS- Таймаут запроса, по умолчанию 10000
TWOGIS_LOCALE- Локаль маршрутов, по умолчанию ru
Ограничения
Нужен API-ключ 2ГИС. Демо-ключ действует около месяца и ограничен примерно тысячей запросов на сервис, для поиска мест еще и размером страниц. Маршруты и общественный транспорт работают, только если они включены в подписку, иначе API вернет 403. Ключ, привязанный к App ID мобильного SDK, не подойдет. Координаты передаются в порядке долгота, широта.
Как отключить. Уберите блок 2gis из конфигурации MCP-клиента или удалите сервер командой claude mcp remove 2gis.
Частые вопросы
Почему поиск ничего не находит?
Чаще всего координаты переданы как широта, долгота. Сервер ожидает сначала долготу.
Откуда взять ID рубрики?
Из поля rubrics в результатах search_places или из ресурса 2gis://rubrics.
Чем 2GIS MCP отличается от других серверов с 2ГИС?
Сервер дает агенту девять инструментов 2ГИС, и все они только на чтение. Агент ищет места и организации рядом с точкой, по рубрике или по запросу, получает карточку места по ID, переводит адрес в координаты, строит маршруты и показывает рейтинги.
Почему поиск ничего не находит и откуда взять ID рубрики?
Проверьте точку, радиус и написание запроса: поиск идет вокруг координат. ID рубрики берется из поля rubrics в результатах search_places или из ресурса 2gis://rubrics. Установка: конфиг с командой npx в блоке установки, работает в Claude Desktop и Claude Code.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
2ГИС — все инструменты2GIS MCP
2GIS MCP (mapgl-mcp-server)
Официальный MCP-сервер 2ГИС: поиск мест, геокодирование, маршруты, изохроны и статичные карты через 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 перечисляет девять инструментов и объясняет, как получить ключ 2ГИС и какие сервисы он покрывает в зависимости от подписки. Описаны ограничения демо-ключа, порядок координат, пагинация и типичная цепочка вызовов от поиска к карточке места. Отдельно оговорено, что тексты отзывов берутся из неофициального метода. Есть таблица типовых ошибок и их причин. Лицензия MIT.