MCP-сервер MapGL от 2ГИС
2GIS MCP (mapgl-mcp-server)
Официальный MCP-сервер 2ГИС поверх MapGL JS API: поиск мест, геокодирование, маршруты и изохроны, работает с демо-ключом без регистрации
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает карты, места и маршруты, ничего не меняет во внешних системах
- Расходует квоту API-ключа при каждом запросе
Установка
Ручная установка
git clone https://github.com/2gis/2gis-mcp.git && cd 2gis-mcp && npm install && npm run buildПакет не опубликован в npm, сборка из исходников по package.json репозитория.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту шесть инструментов на базе MapGL JS API 2ГИС: search_poi ищет организации и места по запросу рядом с точкой в заданном радиусе, calculate_route строит маршрут между точками, где старт и финиш можно задать координатами или текстовым адресом, geocode и reverse_geocode переводят адрес в координаты и обратно, create_map_view формирует параметры карты, calculate_isochrone считает зону доступности. Ключ MAPGL_API_KEY по умолчанию равен demo, то есть базовые запросы работают без собственной регистрации, а ROUTING_API_KEY нужен отдельно для маршрутов.
Для кого. Для разработчиков и аналитиков, которым нужны карты, поиск мест и маршруты 2ГИС по городам России и СНГ прямо в агенте.
Подходит, если
- Нужно найти организации нужного типа рядом с точкой на карте
- Нужно построить маршрут между адресами или координатами
- Нужно быстро попробовать MapGL API без оформления собственного ключа
Не подходит, если
- Нужны маршруты в продакшене: демо-ключ MAPGL_API_KEY не предназначен для постоянной нагрузки
- Проект не опубликован в npm, потребуется собрать его из исходников самостоятельно
Пример запроса к агенту
Найди кофейни в радиусе 500 метров от Красной площади и построй маршрут пешком до ближайшейОграничения
Пакет не опубликован в npm, ставить нужно клонированием репозитория и сборкой через npm run build. README на странице проекта не описывает инструменты и переменные окружения, они видны только в исходном коде. Демо-ключ MAPGL_API_KEY ограничен и не подходит для постоянного использования, для маршрутов дополнительно нужен ROUTING_API_KEY. Проект пока без релизов и без звезд, но принадлежит официальной организации 2ГИС.
Как отключить. Удалите блок сервера из конфигурации MCP клиента и остановите процесс node.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MAPGL_API_KEY секрет | Ключ MapGL API, по умолчанию demo для первых запросов. |
| ROUTING_API_KEY секрет | Отдельный ключ для маршрутов и изохрон. |
Проверка безопасности
- Только читает карты, места и маршруты, ничего не меняет во внешних системах
- Расходует квоту API-ключа при каждом запросе
Коротко о README
README на репозитории состоит из одного абзаца: название, назначение и ссылка на документацию docs.2gis.com/api/ai/mcp-server. Полный список из шести инструментов, схемы параметров и переменные окружения MAPGL_API_KEY и ROUTING_API_KEY видны только в исходном коде src/index.ts и src/mapgl-client.ts. Лицензии MIT и MIT на русском в двух файлах.
Частые вопросы
Нужен ли свой ключ для старта?
Нет, MAPGL_API_KEY по умолчанию равен demo и подходит для первых запросов поиска и геокодирования.
Почему маршруты не строятся?
Для calculate_route и изохрон нужен отдельный ключ ROUTING_API_KEY, демо-ключ карты его не заменяет.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики