Skip to content
appsgit

GeoLens

GeoLens is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Read-only access to a self-hosted GeoLens spatial catalog: datasets, features, maps, sandboxed SQL. It has 271 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx geolens-mcp.

github.com/geolens-io/geolens (opens in a new tab)

View on GitHub (opens in a new tab)Website (opens in a new tab)

Install GeoLens

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "geolens": {
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "your-value",
        "GEOLENS_API_KEY": "your-value",
        "GEOLENS_TOKEN": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env GEOLENS_INSTANCE=your-value --env GEOLENS_API_KEY=your-value --env GEOLENS_TOKEN=your-value --transport stdio geolens -- uvx geolens-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "geolens": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "your-value",
        "GEOLENS_API_KEY": "your-value",
        "GEOLENS_TOKEN": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "geolens_api_key",
      "description": "GEOLENS_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "geolens_token",
      "description": "GEOLENS_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "geolens": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "your-value",
        "GEOLENS_API_KEY": "${input:geolens_api_key}",
        "GEOLENS_TOKEN": "${input:geolens_token}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
GEOLENS_INSTANCEYesBase URL of the GeoLens instance, e.g. https://geolens.example.com (the /api suffix is appended automatically).
GEOLENS_API_KEYsecretNoAPI key, sent as X-Api-Key. Omit for public-only access.
GEOLENS_TOKENsecretNoJWT bearer token, used only when GEOLENSAPIKEY is unset.

Tools (6)

Parsed from the Tools section of the README; check the repository for the current list.

  • search_datasets

    Catalog search by free text (semantic ranking where the instance enables it).

  • get_dataset_schema

    A dataset's columns, geometry type, CRS/SRID, feature count, extent, and source trust metadata.

  • get_features

    Bounded GeoJSON features for a dataset (OGC API — Features), with optional bbox.

  • list_maps

    Saved maps (id, name, visibility, layer count).

  • get_map

    One saved map's full metadata, including layers and view state.

  • query

    One read-only SQL SELECT through the server's hardened sandbox (#565): single statement over data.

About GeoLens

Apache-2.0 read-only Model Context Protocol server for GeoLens. Point a coding agent (Claude Code, Cursor, Codex, …) at a GeoLens instance so it can discover datasets, inspect schemas, read features and maps, and run read-only SQL from inside a dev session.

  • cloud-optimized-geotiff
  • data-catalog
  • fastapi
  • geojson
  • geospatial
  • gis
  • maplibre
  • ogc-api
  • pgvector
  • postgis

Similar MCP servers

More developer tools MCP servers

All Developer tools

FAQ

GeoLens FAQ

Still curious? Email info@appsgit.com.

What is GeoLens?

GeoLens is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Read-only access to a self-hosted GeoLens spatial catalog: datasets, features, maps, sandboxed SQL. It has 271 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx geolens-mcp. The source code is at github.com/geolens-io/geolens.

How do I install the GeoLens MCP server?

Add the command uvx geolens-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is GeoLens free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (GEOLENS_API_KEY and GEOLENS_TOKEN) for the service it connects to, which may require a paid account.

Is GeoLens actively maintained?

The most recent commit was on Oct 6, 2026. The latest release is v1.22.0, published Oct 5, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.