2GIS MCP
@theyahia/2gis-mcp
MCP-сервер для API 2ГИС: поиск мест, геокодирование, маршруты, общественный транспорт, подсказки адресов и рейтинги
Установка
{
"mcpServers": {
"2gis": {
"command": "npx",
"args": ["-y", "@theyahia/2gis-mcp"],
"env": { "TWOGIS_API_KEY": "your-key" }
}
}
}Подходит для Claude Desktop и Claude Code. Можно задать TWOGIS_TIMEOUT_MS и TWOGIS_LOCALE.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту девять инструментов 2ГИС, все только на чтение. Можно искать места и организации рядом с точкой, по рубрике или по запросу, получать карточку места по ID, переводить адрес в координаты и обратно. Маршруты строятся для машины, пешком, на велосипеде, такси, самокате и отдельно на общественном транспорте. Для отзывов сервер всегда возвращает рейтинг и число отзывов, а тексты пытается получить через недокументированный метод. Покрытие: Россия, СНГ и другие регионы 2ГИС.
Для кого. Разработчикам, аналитикам и маркетологам, которым нужны гео-данные и организации в городах России и СНГ.
Подходит, если
- Нужно найти организации нужной категории рядом с адресом
- Нужно геокодировать список адресов или определить адрес по координатам
- Нужно сравнить время в пути на машине и общественном транспорте
Не подходит, если
- Нужны тексты отзывов как надежный источник: их получение неофициальное
- Нужны карты за пределами покрытия 2ГИС
Пример запроса к агенту
Найди аптеки в радиусе километра от площади Ленина в Новосибирске и построй пешеходный маршрут до ближайшейОграничения
Нужен API-ключ 2ГИС. Демо-ключ действует около месяца и ограничен примерно тысячей запросов на сервис, для поиска мест еще и размером страниц. Маршруты и общественный транспорт работают, только если они включены в подписку, иначе API вернет 403. Ключ, привязанный к App ID мобильного SDK, не подойдет. Координаты передаются в порядке долгота, широта.
Как отключить. Уберите блок 2gis из конфигурации MCP-клиента или удалите сервер командой claude mcp remove 2gis.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TWOGIS_API_KEY обязательная, секрет | API-ключ 2ГИС с dev.2gis.com |
| TWOGIS_TIMEOUT_MS | Таймаут запроса, по умолчанию 10000 |
| TWOGIS_LOCALE | Локаль маршрутов, по умолчанию ru |
Проверка безопасности
- Ходит во внешний API 2ГИС и расходует квоту ключа
- Часть данных берется из недокументированного метода
Коротко о README
README перечисляет девять инструментов и объясняет, как получить ключ 2ГИС и какие сервисы он покрывает в зависимости от подписки. Описаны ограничения демо-ключа, порядок координат, пагинация и типичная цепочка вызовов от поиска к карточке места. Отдельно оговорено, что тексты отзывов берутся из неофициального метода. Есть таблица типовых ошибок и их причин. Лицензия MIT.
Частые вопросы
Почему поиск ничего не находит?
Чаще всего координаты переданы как широта, долгота. Сервер ожидает сначала долготу.
Откуда взять ID рубрики?
Из поля rubrics в результатах search_places или из ресурса 2gis://rubrics.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения