# GeoLens

Подключает ИИ-агента к вашему инстансу GeoLens: он находит датасеты, смотрит схемы, читает фичи и карты, выполняет SQL только на чтение.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 281
- Автор: geolens-io
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/geolens-io/geolens/tree/HEAD/mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/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`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `GEOLENS_INSTANCE`, `GEOLENS_API_KEY`, `GEOLENS_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- найти нужный датасет в каталоге GeoLens, не открывая веб-интерфейс
- посмотреть схему слоя перед тем, как писать к нему запрос
- вытащить фичи и карты в текущую сессию разработки
- прогнать SQL на чтение по пространственным данным
- сверить, что у агента нет лишних прав на запись

## Примеры запросов агенту
- Покажи все датасеты в GeoLens и их схемы
- Выполни read-only SQL: сколько фич в слое `roads`
- Достань карту `city_center` и перечисли её слои

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [dbx](https://affpapa.org/nevibecode/mcp/dbx.md) — MCP-сервер · ★ 27669
- [Metabase](https://affpapa.org/nevibecode/mcp/metabase.md) — MCP-сервер · ★ 49845

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md