GeoLens — MCP-сервер для Claude Code: доступ к пространственному
Подключает ИИ-агента к вашему инстансу GeoLens: он находит датасеты, смотрит схемы, читает фичи и карты, выполняет SQL только на чтение.
claude mcp add geolens -e GEOLENS_INSTANCE=<GEOLENS_INSTANCE> -e GEOLENS_API_KEY=<GEOLENS_API_KEY> -e GEOLENS_TOKEN=<GEOLENS_TOKEN> -- uvx geolens-mcpЧто делает GeoLens
Сервер работает поверх Model Context Protocol и открывает агенту пространственный каталог GeoLens прямо в сессии разработки. Агент может перечислить датасеты, разобрать их схемы, вытащить фичи и карты, прогнать запрос на чтение. Инструментов записи, загрузки данных и администрирования здесь нет, и каждый вызов ограничен правами того, кто его делает.
Ставится из PyPI: pip install geolens-mcp или запуск через uvx geolens-mcp. Настройки сервер берёт из окружения — GEOLENS_INSTANCE, а для закрытых данных ещё GEOLENS_API_KEY. Без переменной с адресом инстанса сервер не стартует, так что сначала заведите её в конфиге клиента.
Список инструментов и правила работы с учётными данными лежат в MCP-руководстве GeoLens. Для отладки самого сервера в репозитории есть тесты: uv run --extra dev python -m pytest -v из каталога mcp.
Какие задачи решает
- найти нужный датасет в каталоге GeoLens, не открывая веб-интерфейс
- посмотреть схему слоя перед тем, как писать к нему запрос
- вытащить фичи и карты в текущую сессию разработки
- прогнать SQL на чтение по пространственным данным
- сверить, что у агента нет лишних прав на запись
Примеры запросов агенту
- Покажи все датасеты в GeoLens и их схемы
- Выполни read-only SQL: сколько фич в слое
roads - Достань карту
city_centerи перечисли её слои
Как установить GeoLens
Командой платформы
claude mcp add geolens -e GEOLENS_INSTANCE=<GEOLENS_INSTANCE> -e GEOLENS_API_KEY=<GEOLENS_API_KEY> -e GEOLENS_TOKEN=<GEOLENS_TOKEN> -- uvx geolens-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from geolens-mcp <команда>
Командой платформы
codex mcp add mcp --env GEOLENS_INSTANCE=<GEOLENS_INSTANCE> --env GEOLENS_API_KEY=<GEOLENS_API_KEY> --env GEOLENS_TOKEN=<GEOLENS_TOKEN> -- uvx geolens-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from geolens-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"geolens-mcp"
],
"env": {
"GEOLENS_INSTANCE": "<GEOLENS_INSTANCE>",
"GEOLENS_API_KEY": "<GEOLENS_API_KEY>",
"GEOLENS_TOKEN": "<GEOLENS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from geolens-mcp <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"geolens-mcp"
],
"env": {
"GEOLENS_INSTANCE": "<GEOLENS_INSTANCE>",
"GEOLENS_API_KEY": "<GEOLENS_API_KEY>",
"GEOLENS_TOKEN": "<GEOLENS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from geolens-mcp <команда>
Командой платформы
gemini mcp add -e GEOLENS_INSTANCE=<GEOLENS_INSTANCE> -e GEOLENS_API_KEY=<GEOLENS_API_KEY> -e GEOLENS_TOKEN=<GEOLENS_TOKEN> mcp uvx geolens-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from geolens-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о GeoLens
Как установить GeoLens в Claude Code?
Добавьте сервер командой `claude mcp add geolens -e GEOLENS_INSTANCE=<GEOLENS_INSTANCE> -e GEOLENS_API_KEY=<GEOLENS_API_KEY> -e GEOLENS_TOKEN=<GEOLENS_TOKEN> -- uvx geolens-mcp. Перед этим поставьте пакет: pip install geolens-mcp`.
Что делает GeoLens?
Даёт агенту доступ к вашему инстансу GeoLens: поиск датасетов, просмотр схем, чтение фич и карт, SQL на чтение. Запись и администрирование недоступны.
Какие переменные окружения нужны?
GEOLENS_INSTANCE — адрес инстанса, он обязателен. Для непубличных данных добавьте GEOLENS_API_KEY.
