GeoLens MCP Server

by geolens-ioio.github.geolens-io/geolensv1.22.0

Read-only access to a self-hosted GeoLens geospatial catalog: dataset search, schemas, GeoJSON features, saved maps and sandboxed SQL over PostGIS.

272Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install GeoLens MCP server

claude mcp add geolens-io -e GEOLENS_INSTANCE='<geolens-instance>' -e GEOLENS_API_KEY='<geolens-api-key>' -e GEOLENS_TOKEN='<geolens-token>' -- uvx geolens-mcp

{
  "mcpServers": {
    "geolens-io": {
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "<geolens-instance>",
        "GEOLENS_API_KEY": "<geolens-api-key>",
        "GEOLENS_TOKEN": "<geolens-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "geolens-io": {
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "<geolens-instance>",
        "GEOLENS_API_KEY": "<geolens-api-key>",
        "GEOLENS_TOKEN": "<geolens-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "geolens-io": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "<geolens-instance>",
        "GEOLENS_API_KEY": "<geolens-api-key>",
        "GEOLENS_TOKEN": "<geolens-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "geolens-io": {
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "<geolens-instance>",
        "GEOLENS_API_KEY": "<geolens-api-key>",
        "GEOLENS_TOKEN": "<geolens-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GEOLENS_INSTANCE	yes	—	Base URL of the GeoLens instance, e.g. https://geolens.example.com (the /api suffix is appended automatically).
GEOLENS_API_KEY	—	yes	API key, sent as X-Api-Key. Omit for public-only access.
GEOLENS_TOKEN	—	yes	JWT bearer token, used only when GEOLENS_API_KEY is unset.

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-09 · 1d ago · GitHub
Latest release
2026-10-09 · 1d ago · GitHub · v1.23.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 5d ago · official registry · v1.22.0

FAQ

›How do I install the GeoLens MCP server in Claude Code?

Run: claude mcp add geolens-io -e GEOLENS_INSTANCE='<geolens-instance>' -e GEOLENS_API_KEY='<geolens-api-key>' -e GEOLENS_TOKEN='<geolens-token>' -- uvx geolens-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does GeoLens require an API key?

Yes. It expects GEOLENS_INSTANCE, GEOLENS_API_KEY, GEOLENS_TOKEN, of which 2 are secrets.

›Can I use GeoLens as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is GeoLens in the official MCP registry?

Yes, as io.github.geolens-io/geolens.