Geo Explorer MCP server

<!-- mcp-name: io.github.arnienemeth/geo-explorer-mcp -->

geo-explorer-mcp

An MCP server that serves country facts, administrative boundaries and regional statistics as structured data, so an AI assistant can build interactive geography instead of reciting it.

The server deliberately returns data, not prose. It hands back populations, polygons and coordinates; the model decides how to present them — as a clickable map, a comparison table, or a lesson in Slovak, German or Hungarian. Nothing in this server knows how to translate, and it does not need to.

Tools

country accepts a name in almost any language — Slovakia, Slovensko, Magyarország, Magyarorszag (no diacritics), Deutschland, Ungarn.

The two boundary and statistics tools are designed to be joined: getregiondetails returns a matchkey per region, and a joinhint telling the model how to normalise getmapdata's names to match it.

Quick start

git clone https://github.com/arnienemeth/geo-explorer-mcp
cd geo-explorer-mcp
uv sync

Copy .env.example to .env and fill it in:

RESTCOUNTRIES_API_KEY=rc_live_...          # free: https://restcountries.com/sign-up
GEO_EXPLORER_CONTACT=https://github.com/you/your-repo

GEOEXPLORERCONTACT goes into the User-Agent sent to Wikidata. Wikimedia requires a contact URL or email and answers anything else with 403.

Once published to PyPI it also installs with no clone at all:

uvx geo-explorer-mcp

Try it in the MCP Inspector:

uv run fastmcp dev inspector server.py

Claude Desktop

Add this to claudedesktopconfig.json (on Windows, %APPDATA%\Claude\claudedesktopconfig.json), adjusting the paths:

{
  "mcpServers": {
    "geo-explorer": {
      "command": "C:\\path\\to\\geo-explorer-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\geo-explorer-mcp\\server.py"]
    }
  }
}

Pointing at the project's own .venv interpreter means Claude runs exactly what you tested, with no second environment to keep in sync. Restart Claude Desktop fully afterwards — the config is only read at startup.

Then ask it something like:

Show me an interactive map of Slovakia's regions, shaded by population, in German.

Demo page

demo/index.html renders any of four countries from the same two sources the server uses, joined in the browser: shading by population, area or density, capital markers, a sortable table, and per-region links to Wikipedia and Wikidata. One page, parameterised by country — because the server is generic.

It must be served over http, not opened as a file — a file:// page has a null origin and the browser blocks its cross-origin fetches:

cd demo
python -m http.server 8000

The single US miss is the Virgin Islands, which has no ISO 3166-2 entry in Wikidata. Regions without a match render grey rather than being dropped.

Shortened. The full README is on GitHub.