MaxMindDB

stdio

Query IP locations and network ownership in GeoIP2, GeoLite2, and custom MMDB databases.

Getting Started

npx @getmcp/cli add io.github.oschwald/maxminddb

Requires Docker Engine. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

MAXMINDDB_MCP_ACCOUNT_ID
Your MaxMind account ID.
MAXMINDDB_MCP_LICENSE_KEY
A MaxMind license key with access to the selected editions.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.oschwald/maxminddb": {
      "command": "docker",
      "args": [
        "type=volume,source=maxminddb-mcp-data,target=/data",
        "MAXMINDDB_MCP_CONFIG=",
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.4.0"
      ],
      "env": {
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED": "true",
        "MAXMINDDB_MCP_DATABASE_DIR": "/data",
        "MAXMINDDB_MCP_ACCOUNT_ID": "",
        "MAXMINDDB_MCP_LICENSE_KEY": "",
        "MAXMINDDB_MCP_EDITIONS": "GeoLite2-City,GeoLite2-ASN"
      }
    }
  }
}

Claude Desktop MCP documentation