MCP-сервер поиска 2ГИС
2GIS Search MCP Server
Community MCP-сервер поверх поискового API 2ГИС: места, геокодер, подсказки, категории и регионы, свой ключ 2ГИС и Docker Compose
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Сервер только читает публичные данные поиска и геокодирования
- Ключ 2ГИС хранится в .env на вашей стороне
Установка
Ручная установка
uv sync && python3 -m src.main --transport stdioЛокальный запуск по stdio после создания .env с ключом.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает 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ГИСОграничения
Нужен собственный ключ 2ГИС API Console, 2ГИС может запросить описание сценария использования и ограничить регион или объем. Проект небольшой, без готового npm или PyPI пакета, ставится клонированием репозитория и uv sync. Маршрутов и изохрон нет, только Search API.
Как отключить. Удалите сервер из конфигурации MCP-клиента и остановите контейнер командой docker-compose down, если использовали Docker.
MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| DGIS_API_KEY обязательная, секрет | Ключ 2ГИС API Console для Search API. |
| DGIS_SEARCH_API_URL обязательная | Базовый адрес API, по умолчанию https://catalog.api.2gis.com. |
Проверка безопасности
- Сервер только читает публичные данные поиска и геокодирования
- Ключ 2ГИС хранится в .env на вашей стороне
Коротко о README
README на английском описывает сервер как простую обертку над 2GIS Search API, дает инструкцию получения ключа на dev.2gis.com, шаги установки через uv sync, запуск с параметрами transport, host, port и debug, а также вариант через Docker Compose с streamable-http на порту 8101 и проверку через MCP Inspector.
Частые вопросы
Где взять ключ 2ГИС?
На dev.2gis.com нужно зарегистрироваться и создать проект с API-ключом для Search API, 2ГИС может запросить описание сценария использования.
Можно ли строить маршруты этим сервером?
Нет, он покрывает только поиск, геокодирование, подсказки, категории и регионы Search API.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики