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 301 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)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
- Official
- Needs API key
- Developer tools
- Apache-2.0
- Active
Install GeoLens
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"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-mcpCursor
{
"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
{
"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.
| Name | Required | Description |
|---|---|---|
GEOLENS_INSTANCE | Yes | Base URL of the GeoLens instance, e.g. https://geolens.example.com (the /api suffix is appended automatically). |
GEOLENS_API_KEYsecret | No | API key, sent as X-Api-Key. Omit for public-only access. |
GEOLENS_TOKENsecret | No | JWT bearer token, used only when GEOLENSAPIKEY is unset. |
Tools (5)
Parsed from the Tools section of the README; check the repository for the current list.
search_datasetsgetdatasetschema, getfeatures: find datasets, read their columns and page through features.
list_mapsgetmap: saved maps and their layers.
list_storiesgetstory: published stories and their chapters. Drafts are never read.
aggregateexact counts, statistics, histograms, group-bys and row pages over one dataset.
queryone sandboxed SELECT. Use aggregate for counts and summaries.
About 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. With a mapauthor API key it can also create private maps and add, style and frame their layers. It has no ingest, delete, sharing or admin tools, and every call is scoped to the caller's access.
- cloud-optimized-geotiff
- data-catalog
- fastapi
- geojson
- geospatial
- gis
- maplibre
- ogc-api
- pgvector
- postgis
Similar MCP servers
More developer tools MCP servers
Emulo
ohad6k/emulo
Mine your AI coding session logs into a you.md profile with dated receipts, for an agent to read.
Active · last commit Oct 2, 2026
Developer toolsHTMLFunseaAI Unity MCP
FunplayAI/funplay-unity-mcp
stdio bridge for the local Unity Editor MCP server from FunseaAI/unity-mcp.
Active · last commit Nov 12, 2026
OfficialDeveloper toolsC#LLM Context.py
cyberchitta/llm-context.py
Share code with LLMs via Model Context Protocol or clipboard.
Maintained · last commit Nov 15, 2026
Developer toolsPythonMirroir MCP
jfarcand/mirroir-mcp
Drive a stock iPhone via iPhone Mirroring: no Developer Mode, Xcode or WDA.
Active · last commit Nov 15, 2026
Developer toolsSwiftHeyClaude — Claude & AI workflow directory
JSONbored/awesome-claude
Search the HeyClaude directory of Claude Code agents, MCP servers, skills, and tools.
Active · last commit Nov 3, 2026
Developer toolsMDXGimp MCP
gimp-mcp/gimp-mcp
AI agent using GIMP MCP to remove a background, edit a character's expression, and verify results — all through natural language via Claude.
Maintained · last commit Nov 15, 2026
Developer toolsPython
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 Nov 16, 2026. The latest release is v1.31.0, published Nov 10, 2026. appsgit only lists MCP servers with a commit in the last six months.