2ГИС MCP

2gis/2gis-mcp· Проверено 12.11.2026· 6на GitHub

Подключает агента к API 2ГИС: найти места и организации, перевести адрес в координаты и обратно, построить маршрут, зону доступности и картинку карты с метками.

2 реализации:

Сервер от 2ГИС: поиск мест, геокодер, маршруты с учётом пробок, изохроны и статичная карта PNG.

Как подключить

Что сделать до подключения

Node.js; склонировать репозиторий, выполнить npm install и npm run build

Ключ API 2ГИС; без MAPGL_API_KEY сервер подставляет ключ demo, без ROUTING_API_KEY — тот же ключ для маршрутов

MAPGL_API_KEY

ключ для поиска и геокодера API 2ГИС

ROUTING_API_KEY

необязательно: отдельный ключ для маршрутов и изохрон

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MAPGL_API_KEY=<ключ API 2ГИС>' --env 'ROUTING_API_KEY=<ключ маршрутизации, если отдельный>' --transport stdio 2gis \
  -- node /path/to/2gis-mcp/dist/index.js

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.2gis]
command = "node"
args = ["/path/to/2gis-mcp/dist/index.js"]

[mcp_servers.2gis.env]
MAPGL_API_KEY = "<ключ API 2ГИС>"
ROUTING_API_KEY = "<ключ маршрутизации, если отдельный>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "2gis": {
      "command": "node",
      "args": ["/path/to/2gis-mcp/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<ключ API 2ГИС>",
        "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "2gis": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/2gis-mcp/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<ключ API 2ГИС>",
        "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "2gis": {
      "command": "node",
      "args": ["/path/to/2gis-mcp/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<ключ API 2ГИС>",
        "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "2gis": {
      "command": "node",
      "args": ["/path/to/2gis-mcp/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<ключ API 2ГИС>",
        "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "2gis": {
        "type": "local",
        "command": ["node", "/path/to/2gis-mcp/dist/index.js"],
        "environment": {
          "MAPGL_API_KEY": "<ключ API 2ГИС>",
          "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "2gis": {
      "command": "node",
      "args": ["/path/to/2gis-mcp/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<ключ API 2ГИС>",
        "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "2gis": {
      "command": "node",
      "args": ["/path/to/2gis-mcp/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<ключ API 2ГИС>",
        "ROUTING_API_KEY": "<ключ маршрутизации, если отдельный>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

search_poiищет места в радиусе от точки

geocodeпереводит адрес в координаты

reverse_geocodeнаходит адрес по координатам

calculate_routeстроит маршрут через точки

calculate_isochroneстроит зону доступности

create_map_viewрисует карту PNG с метками

Ставится через npx без сборки; кроме поиска и маршрутов даёт общественный транспорт, автоподсказки адресов, карточку места и отзывы. Все инструменты только читают.

Как подключить

Что сделать до подключения

Node.js с командой npx

Ключ на dev.2gis.com; для пробы подойдёт бесплатный демо-ключ

TWOGIS_API_KEY

dev.2gis.com → ключ подписки; ключ с App ID для мобильного SDK не подходит, нужен отдельный

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'TWOGIS_API_KEY=<ключ API 2ГИС>' --transport stdio mcp-2gis-mcp \
  -- npx -y @theyahia/2gis-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-2gis-mcp]
command = "npx"
args = ["-y", "@theyahia/2gis-mcp"]

[mcp_servers.mcp-2gis-mcp.env]
TWOGIS_API_KEY = "<ключ API 2ГИС>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-2gis-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": {
        "TWOGIS_API_KEY": "<ключ API 2ГИС>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-2gis-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": {
        "TWOGIS_API_KEY": "<ключ API 2ГИС>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-2gis-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": {
        "TWOGIS_API_KEY": "<ключ API 2ГИС>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-2gis-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": {
        "TWOGIS_API_KEY": "<ключ API 2ГИС>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-2gis-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@theyahia/2gis-mcp"],
        "environment": {
          "TWOGIS_API_KEY": "<ключ API 2ГИС>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-2gis-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": {
        "TWOGIS_API_KEY": "<ключ API 2ГИС>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-2gis-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": {
        "TWOGIS_API_KEY": "<ключ API 2ГИС>"
      }
    }
  }
}

Инструменты сервера

search_placesищет места и организации

get_placeоткрывает карточку места по ID

search_by_rubricищет по рубрике рядом с точкой

geocodeпереводит адрес в координаты

reverse_geocodeнаходит адрес по координатам

get_directionsстроит маршрут на авто, пешком, на велосипеде

get_public_transportстроит маршрут на общественном транспорте

suggestподсказывает адреса и места

get_reviewsпоказывает рейтинг и отзывы

Что попросить агента

«Найди кофейни у центра Новосибирска в 2ГИС»Агент вызовет search_places или search_poi с точкой и радиусом

«Что находится по координатам 55.0302, 82.9204?»Агент вызовет reverse_geocode

«Пешеходный маршрут от 55.0302,82.9204 до 54.8430,83.0972»Агент вызовет get_directions или calculate_route с профилем pedestrian

«Как доехать на общественном транспорте от площади Ленина до Академгородка?»Агент вызовет get_public_transport

«Рейтинг и отзывы для места 141265770013120»Агент вызовет get_reviews

Для каких задач

Найти кофейни, аптеки или другие места рядом с точкой

Перевести список адресов в координаты и обратно

Построить маршрут на машине, пешком или на общественном транспорте

Показать, куда можно доехать за 15 или 30 минут, зоной доступности

Нарисовать карту PNG с метками, маршрутом и областями

Посмотреть рейтинг и число отзывов организации

Ограничения

Данные покрывают Россию, СНГ и другие регионы 2ГИС; ответы приходят в основном на русском

Демо-ключ живёт около месяца и даёт около 1000 запросов на каждый сервис, в поиске мест — не больше 10 результатов на страницу и 5 страниц

Маршруты и общественный транспорт работают, только если они включены в вашу подписку; иначе приходит ответ 403

Тексты отзывов @theyahia/2gis-mcp берёт из недокументированного внутреннего адреса: для многих ключей приходит только рейтинг и число отзывов

Если не работает

Authentication failed (401)

Ключ TWOGIS_API_KEY неверный или пустой.

Access forbidden (403)

Сервис не включён в подписку или используется ключ мобильного SDK с App ID. Создайте отдельный ключ для HTTP API.

Rate limit exceeded (429)

Исчерпана квота сервиса. Сервер сам повторяет запрос с паузами, потом возвращает ошибку.

Request timed out

2ГИС отвечает медленно. Увеличьте TWOGIS_TIMEOUT_MS, по умолчанию 10000 мс.

Поиск возвращает пустой no_results

Совпадений нет или координаты переданы как широта,долгота. Нужен порядок долгота,широта.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
2GIS MCPразработчик сервиса	2ГИС	6	локально	токен	6	16 октября 2026
@theyahia/2gis-mcp	theYahia	4	локально	токен	9	6 сентября 2026

Частые вопросы

Какой из серверов выбрать?

Сервер 2ГИС строит изохроны и рисует карту PNG, его нужно собрать из исходников. @theyahia/2gis-mcp ставится через npx и добавляет общественный транспорт, автоподсказки, карточку места и отзывы.

В каком порядке писать координаты?

В @theyahia/2gis-mcp параметр point принимает сначала долготу, потом широту: "82.92,55.03". Сервер 2ГИС принимает объект {"lat": 55.75, "lng": 37.62} или текстовый адрес.

Нужен ли ключ для карты PNG?

Нет, create_map_view работает через Static Maps API без ключа. Для поиска, геокодера и маршрутов ключ нужен.

Какие виды транспорта есть в маршрутах?

calculate_route у сервера 2ГИС: car, taxi, pedestrian, bicycle, scooter, motorcycle и truck, с учётом пробок или средней статистики. Изохроны: car, pedestrian, bicycle и public_transport.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и обращаются к API 2ГИС по ключу с dev.2gis.com; зарубежные аккаунты не нужны.

2ГИС MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы