MaxMindDB

Name: MaxMindDB
Author: oschwald

oschwald

A powerful Model Context Protocol (MCP) server that provides comprehensive geolocation and network intelligence through MaxMindDB files

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add maxminddb --env MAXMINDDB_MCP_ACCOUNT_ID='<MAXMINDDB_MCP_ACCOUNT_ID>' --env MAXMINDDB_MCP_LICENSE_KEY='<MAXMINDDB_MCP_LICENSE_KEY>' -- docker run -i --rm -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY ghcr.io/oschwald/maxminddb-mcp:0.4.0

~/.codex/config.toml

[mcp_servers.maxminddb]
command = "docker"
args = ["run", "-i", "--rm", "-e", "MAXMINDDB_MCP_ACCOUNT_ID", "-e", "MAXMINDDB_MCP_LICENSE_KEY", "ghcr.io/oschwald/maxminddb-mcp:0.4.0"]
env = { MAXMINDDB_MCP_ACCOUNT_ID = "<MAXMINDDB_MCP_ACCOUNT_ID>", MAXMINDDB_MCP_LICENSE_KEY = "<MAXMINDDB_MCP_LICENSE_KEY>" }

# codex mcp add maxminddb --env MAXMINDDB_MCP_ACCOUNT_ID='<MAXMINDDB_MCP_ACCOUNT_ID>' --env MAXMINDDB_MCP_LICENSE_KEY='<MAXMINDDB_MCP_LICENSE_KEY>' -- docker run -i --rm -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY ghcr.io/oschwald/maxminddb-mcp:0.4.0

~/.cursor/mcp.json

{
  "mcpServers": {
    "maxminddb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "ghcr.io/oschwald/maxminddb-mcp:0.4.0"
      ],
      "env": {
        "MAXMINDDB_MCP_ACCOUNT_ID": "<MAXMINDDB_MCP_ACCOUNT_ID>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<MAXMINDDB_MCP_LICENSE_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "maxminddb": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "ghcr.io/oschwald/maxminddb-mcp:0.4.0"
      ],
      "env": {
        "MAXMINDDB_MCP_ACCOUNT_ID": "<MAXMINDDB_MCP_ACCOUNT_ID>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<MAXMINDDB_MCP_LICENSE_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "maxminddb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "ghcr.io/oschwald/maxminddb-mcp:0.4.0"
      ],
      "env": {
        "MAXMINDDB_MCP_ACCOUNT_ID": "<MAXMINDDB_MCP_ACCOUNT_ID>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<MAXMINDDB_MCP_LICENSE_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "maxminddb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "ghcr.io/oschwald/maxminddb-mcp:0.4.0"
      ],
      "env": {
        "MAXMINDDB_MCP_ACCOUNT_ID": "<MAXMINDDB_MCP_ACCOUNT_ID>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<MAXMINDDB_MCP_LICENSE_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "maxminddb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "ghcr.io/oschwald/maxminddb-mcp:0.4.0"
      ],
      "env": {
        "MAXMINDDB_MCP_ACCOUNT_ID": "<MAXMINDDB_MCP_ACCOUNT_ID>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<MAXMINDDB_MCP_LICENSE_KEY>"
      }
    }
  }
}

Environment variables

MAXMINDDB_MCP_ACCOUNT_ID
MAXMINDDB_MCP_LICENSE_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related