mmdb-server is an open source fast API server to lookup IP addresses for their geographic location, AS number. The server can be used with any MaxMind DB File Format or file in the same format. The server includes the open and free Geo Open - IP address geolocation per country in MMDB format 🗺️.

This version fixes a small bug with the lookup of unknown countries and include an update of the free Geo Open database.

For more and details.

mmdb-server v1.0 released - an open source fast API server to lookup IP addresses for their geographic location. The server reached version 1.0 as many production servers are running flawlessly with this code. mmdb-server includes the geo-open database from CIRCL.

mmdb-server (the open and free geo IP server) version 0.5 released (2022-02-06) 🗺️

mmdb-server (the open and free geo IP server) version 0.5 released which includes the support for to load multiple MMDB files.

A new GeoOpen database included to support AS number and AS description lookup.

New

• [multiple MMDB file support] MMDB server can now load a list of MMDB files + new GeoOpen file including ASN details added as example. [Alexandre Dulaunoy]

  GeoOpen files for country only -> https://cra.circl.lu/opendata/geo-open/mmdb-country/ GeoOpen files with country and ASN/ASN description -> https://cra.circl.lu/opendata/geo-open/mmdb-country-asn/

• [db] Country-ASN db added. [Alexandre Dulaunoy]

• [db] GeoOpen database updated. [Alexandre Dulaunoy]

Changes

• [doc] update the documentation and examples with the multiple sources. [Alexandre Dulaunoy]

• [log] remove old debug. [Alexandre Dulaunoy]

• [db] renamed. [Alexandre Dulaunoy]

• [GeoOpen-country] updated. [Alexandre Dulaunoy]

Other

• Update README.md. [Alexandre Dulaunoy]

What's new in v0.2 (2022-01-24)

New

• [server] Add additional information about the country including average location, complete name and numeric code. [Alexandre Dulaunoy]

• [mygeolookup] Query on root of the server will give the geo location of the remote IP address doing the query. [Alexandre Dulaunoy]

Changes

• [doc] update JSON output and CIRCL public service. [Alexandre Dulaunoy]

• [server] display port. [Alexandre Dulaunoy]

• [server] make port configurable. [Alexandre Dulaunoy]

mmdb-server is an open source fast API server to lookup IP addresses for their geographic location. The server can be used with any MaxMind DB File Format or file in the same format.

mmdb-server includes a free and open GeoOpen-Country database for IPv4 and IPv6 addresses. The file GeoOpen-Country is generated on a regular basis from AS announces and their respective whois records.

Installation

Python 3.8+ is required to run the mmdb-server with some additional requirements.

• pip3 install -r REQUIREMENTS
• cp ./etc/server.conf.sample ./etc/server.conf
• cd bin; python3 server.py

Usage

Lookup of an IP address

curl -s http://127.0.0.1:8000/geolookup/188.65.220.25 | jq .

[
  {
    "country": {
      "iso_code": "BE"
    },
    "meta": {
      "description": {
        "en": "Geo Open MMDB database - https://github.com/adulau/mmdb-server"
      },
      "build_db": "2022-01-23 16:13:05",
      "db_source": "GeoOpen-Country",
      "nb_nodes": 1156125
    }
  }
]

$ curl -s http://127.0.0.1:8000/geolookup/2a02:21d0::68:69:25 | jq .

[
  {
    "country": {
      "iso_code": "BE"
    },
    "meta": {
      "description": {
        "en": "Geo Open MMDB database - https://github.com/adulau/mmdb-server"
      },
      "build_db": "2022-01-23 16:13:05",
      "db_source": "GeoOpen-Country",
      "nb_nodes": 1156125
    }
  }
]

Output format

The output format is an array of JSON object (to support the ability to serve multiple geo location database). Each JSON object of the JSON array includes a meta and a country fields. The country give the geo graphic location of the IP address queried. The meta field includes the origin of the MMDB database which the the metadata.