GeoLens MCP
MCP только на чтение для каталога геоданных GeoLens: наборы, схемы, объекты, карты, истории и безопасный SELECT.
- 297 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Сервер только читает, но данные каталога и результаты запросов попадают в контекст модели.
Установка
- Работает в
Ручная установка
pip install geolens-mcpПакет из PyPI, запуск `uvx geolens-mcp`. Адрес экземпляра задает `GEOLENS_INSTANCE`.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер только читает, но данные каталога и результаты запросов попадают в контекст модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
GeoLens — самостоятельно разворачиваемый каталог геоданных с семантическим поиском на `pgvector` и API OGC и STAC. Его сервер `geolens-mcp` открывает каталог агентам Claude Code, Cursor, Codex и другим клиентам только на чтение: без инструментов записи, загрузки и администрирования. Каждый вызов ограничен правами вызывающего. Инструменты: `search_datasets`, `get_dataset_schema` и `get_features` ищут наборы данных, показывают колонки и листают объекты. `list_maps` и `get_map` отдают сохраненные карты со слоями, `list_stories` и `get_story` опубликованные истории с главами. `aggregate` считает точные количества, статистику, гистограммы и группировки по одному набору данных. `query` выполняет один SELECT в песочнице. Адрес экземпляра задает `GEOLENS_INSTANCE`, ключ `GEOLENS_API_KEY` нужен для непубличных данных.
Для кого. Разработчикам и аналитикам геоданных, у которых развернут GeoLens и которые хотят читать каталог из сессии Claude Code, Cursor или Codex.
Подходит, если
- Агент ищет наборы данных по теме и показывает колонки перед написанием кода.
- Считают количество объектов по районам запросом `aggregate` с группировкой.
- Опубликованные истории и их главы читают для сводки материалов.
- Один безопасный SELECT выполняют, когда агрегатов недостаточно.
Не подходит, если
- Нужна загрузка или правка данных: сервер не содержит инструментов записи.
- Нет развернутого GeoLens: сервер читает конкретный экземпляр каталога.
- Нужен доступ к черновикам историй: они никогда не читаются.
Пример запроса к агенту
Найди наборы данных про здания, покажи схему лучшего из них и посчитай количество объектов по районам.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
GEOLENS_INSTANCEобязательная- Адрес вашего экземпляра GeoLens
GEOLENS_API_KEYсекрет- Ключ API для непубличных данных
Ограничения
Сервер работает с одним экземпляром GeoLens, его адрес задает `GEOLENS_INSTANCE`, для непубличных данных нужен `GEOLENS_API_KEY`. Все инструменты только читают и ограничены правами вызывающего, черновики историй не читаются. Агрегаты сохраняют лимиты маршрута: отказ `too_wide` означает, что выбранная область содержит больше 500 000 строк и ее нужно сузить, а `query_busy` сообщает, что уже идут два агрегата, и запрос повторяют после паузы. Для `query` разрешен один SELECT в песочнице, для подсчетов предназначен `aggregate`.
Как отключить. Удалите запись `geolens` из клиента и отзовите ключ `GEOLENS_API_KEY` в вашем экземпляре GeoLens. Данные каталога остаются нетронутыми.
Частые вопросы
Как установить?
`pip install geolens-mcp` или запуск `uvx geolens-mcp`. Адрес экземпляра задают переменной `GEOLENS_INSTANCE`.
Нужен ли ключ?
Только для непубличных данных: `GEOLENS_API_KEY`. Публичный каталог читается без него.
Что делать при отказе `too_wide`?
Сузить рамку `bbox`: она содержит больше 500 000 строк. Для `query_busy` подождите и повторите запрос.
Есть ли инструменты записи?
Нет. Сервер только читает, без загрузки, администрирования и записи, каждый вызов ограничен правами вызывающего.
Где полное руководство?
На странице `docs.getgeolens.com/guides/sdk/mcp/`: настройка клиентов, список инструментов и правила для ключей.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверы2GIS MCP
2GIS MCP (mapgl-mcp-server)
Официальный MCP-сервер 2ГИС: поиск мест, геокодирование, маршруты, изохроны и статичные карты через API 2ГИС, нужен ключ из Менеджера Платформы
Управление 3D-глобусом CesiumJS из ИИ: 62 команды камеры, слоев, моделей и анимации через MCP, WebMCP или вызов функций
MCP-сервер для PostgreSQL с несколькими базами сразу, описаниями таблиц из каталога, подсказками по PostGIS и pgvector и планами запросов
MCP для анализа земельных участков
Construction Maps MCP Server
MCP-сервер для предпроектного анализа участков: границы Росреестра, геокодирование и карты Яндекса, инфраструктура и геометрия
MCP-сервер с набором инструментов для сводок по миру: рынки, отчеты SEC, конфликты, климат и новости из открытых источников
Официальный MCP-сервер Mapbox: геокодирование, поиск мест, маршруты, изохроны, карты прямо в чате и офлайн-расчеты
Коротко о README
README пакета `geolens-mcp` перечисляет девять инструментов, переменные окружения, ограничения агрегатов и запуск тестов. Общий README GeoLens рассказывает о каталоге и API.