geolocation-mcp

GeoLocation MCP Server

!Coverage

Fast and up-to-date IP geolocation data for LLMs

<details> <summary>Demo</summary>

!demo

</details>

For public IPv4 / IPv6 address:

• Flags: isDatacenter, isTorExitNode, isVPN
• City name, region ISO code, latitude/longitude, accuracy radius, postal code, timezone
• Country name, ISO code, EU membership/GDPR
• ASN number, ISP/organization name, network CIDR

MCP tools

| Tool | Description | | ------------------------ | --------------------------------------------- | | getGeoLocationData | single IP lookup | | getGeoLocationDataBulk | batch lookup, failed IPs don't block the rest |

Data sources

| Data | Source | Refresh | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- | | City / ASN | GeoLite2 via P3TERX/GeoLite.mmdb | on startup if absent | | Tor exit nodes | Tor Project | daily | | VPN / Datacenter ranges | X4BNet/lists_vpn | daily |

Usage

# named volume so DBs persist across restarts
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

or with compose

services:
  geolocation-mcp:
    image: 7mza/geolocation-mcp:latest
    ports:
      - '8891:8080'
    restart: unless-stopped
    volumes:
      - geolocation_data:/home/nonroot/.geolocation-mcp
volumes:
  geolocation_data:
    name: geolocation_data

Connect your LLM:

# example for claude
claude mcp add --transport http geolocation http://localhost:8891/mcp

Test with MCP inspector:

npm i && npm run mcp
# transport: streamable
# url: http://localhost:8891/mcp

Build from source

Requires SDKMAN and nvm.

nvm use && npm i && sdk env install

JVM:

./gradlew clean ktlintFormat ktlintCheck build
./gradlew bootRun

Native:

./gradlew clean ktlintFormat ktlintCheck build -PgenerateMetadata
./gradlew buildImage
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

License

GeoLite2 DBs are subject to the GeoLite2 EULA.