MCP-сервер поиска 2ГИС
2GIS Search MCP Server
Community MCP-сервер поверх поискового API 2ГИС: места, геокодер, подсказки, категории и регионы, свой ключ 2ГИС и Docker Compose
- 1 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Python-сервер, который по ключу 2ГИС ищет места и геокодирует адреса
- Только читает данные Search API
Установка
- Работает в
- Сервисы
Ручная установка
uv sync && python3 -m src.main --transport stdioЛокальный запуск по stdio после создания .env с ключом.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Python-сервер, который по ключу 2ГИС ищет места и геокодирует адреса
- Только читает данные Search API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает 2GIS Search API в инструменты MCP: поиск мест по названию и локации, геокодер для перевода адреса в координаты, автодополнение адресов, поиск категорий бизнеса, поиск регионов по названию и получение маркеров для карты по результатам поиска. Запускается локально по stdio через python3 -m src.main или в Docker Compose с транспортом streamable-http на порту 8101. Ключ и адрес API 2ГИС задаются в .env файле.
Для кого. Для разработчиков и аналитиков, которым нужен простой доступ к поисковому API 2ГИС из агента без готового официального сервера.
Подходит, если
- Нужен поиск мест и организаций 2ГИС по названию рядом с точкой
- Нужен геокодер для перевода адреса в координаты и обратно в собственном пайплайне
- Нужно поднять сервер в Docker Compose с HTTP-транспортом, а не только stdio
Не подходит, если
- Нужны маршруты или изохроны: этот сервер их не считает, только поиск и геокодирование
- Нужен официальный сервер от 2ГИС: это независимый community-проект
Пример запроса к агенту
Найди кофейни в радиусе 500 метров от координат моего офиса через 2ГИСMCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
Переменные окружения
DGIS_API_KEYобязательная, секрет- Ключ 2ГИС API Console для Search API.
DGIS_SEARCH_API_URLобязательная- Базовый адрес API, по умолчанию https://catalog.api.2gis.com.
Ограничения
Нужен собственный ключ 2ГИС API Console, 2ГИС может запросить описание сценария использования и ограничить регион или объем. Проект небольшой, без готового npm или PyPI пакета, ставится клонированием репозитория и uv sync. Маршрутов и изохрон нет, только Search API.
Как отключить. Удалите сервер из конфигурации MCP-клиента и остановите контейнер командой docker-compose down, если использовали Docker.
Частые вопросы
Где взять ключ 2ГИС?
На dev.2gis.com нужно зарегистрироваться и создать проект с API-ключом для Search API, 2ГИС может запросить описание сценария использования.
Можно ли строить маршруты этим сервером?
Нет, он покрывает только поиск, геокодирование, подсказки, категории и регионы Search API.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
2ГИС — все инструменты2GIS MCP
@theyahia/2gis-mcp
MCP-сервер для API 2ГИС: поиск мест, геокодирование, маршруты, общественный транспорт, подсказки адресов и рейтинги
2GIS MCP
2GIS MCP (mapgl-mcp-server)
Официальный MCP-сервер 2ГИС: поиск мест, геокодирование, маршруты, изохроны и статичные карты через API 2ГИС, нужен ключ из Менеджера Платформы
Свой MCP-сервер на Cloudflare Workers для локального SEO: поиск и карточки организаций в 2ГИС, Яндекс Геокодере и Google Places
MapGL MCP Server (прототип)
MapGL MCP Server
Небольшой прототип MCP поверх MapGL JS API 2ГИС: дает LLM доступ к картам для запросов вроде сравнения районов по плотности кафе
Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные
Скилл локального SEO для Google, Яндекс и 2ГИС
Google Yandex 2GIS Local SEO Skill
Скилл аудита локального SEO для рынка СНГ: карточки в Google Business Profile, Яндекс Бизнесе, Яндекс Картах, 2ГИС и их согласованность
Коротко о README
README на английском описывает сервер как простую обертку над 2GIS Search API, дает инструкцию получения ключа на dev.2gis.com, шаги установки через uv sync, запуск с параметрами transport, host, port и debug, а также вариант через Docker Compose с streamable-http на порту 8101 и проверку через MCP Inspector.