2ГИС MCP: Документация
Обновлено:
Подключение
npx -y @theyahia/2gis-mcp (stdio) или HTTP_PORT=3000 npx @theyahia/2gis-mcp --http. Auth: TWOGIS_API_KEY — ключ из личного кабинета разработчика dev.2gis.com (нужны права на разделы Catalog, Geocoder, Routing, Reviews). Ключ передаётся как query-параметр key= в каждом запросе — не логируется и не попадает в тексты ошибок.
Инструменты
8 инструментов: места (search_places — поиск по запросу с опциональным центром и радиусом, get_place — детали места по ID 2ГИС: адрес, график, телефоны, фото, отзывы, search_by_rubric — поиск по рубрике рядом с точкой), геокодинг (geocode, reverse_geocode), маршруты и подсказки (get_directions — авто/пешком/транспорт, suggest — подсказки при вводе), отзывы (get_reviews).
Сценарий для агента
«Найди кофейни в радиусе 1 км от точки в центре Москвы», «построй маршрут на машине от Кремля до Шереметьево», «геокодируй адрес «Москва, Тверская 13» и покажи отзывы о первом найденном месте».
Важно
Community-проект (theYahia), не официальный продукт 2ГИС. В отличие от скрейперов вроде Apify, парсящих карточки 2ГИС в обход API, этот сервер работает строго через официальные эндпоинты — стабильнее, но требует ключ dev.2gis.com и укладывается в его лимиты и тарифы.