GeoLocation MCP Server

Connect your LLMs to GeoLite2 databases for fast and up-to-date IP geolocation data

<details> <summary>Demo</summary>

</details>

Desc

Available MCP tools

HTTP daemon MCP server running in async/steamableHttp modes

Built using Webflux/Reactor and GraalVM native with static/musl/-Os/UPX/distroless optimizations

On start will automatically download GeoLite2 DBs from P3TERX/GeoLite.mmdb

Usage

# named volume so DBs are downloaded once
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

then connect your LLM using MCP conf

example for claude code

claude mcp add --transport http geolocation http://localhost:8891/mcp # --scope local|user

test with mcp inspector

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

Build from source

SDKMAN

nvm

nvm use
npm i
sdk env install

JVM mode :

./gradlew clean ktlintFormat ktlintCheck build
./gradlew bootRun

Native mode:

./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

MaxMind GeoLite2 databases are free but conditioned by GeoLite2 End User License Agreement