MaxMindDB MCP Server

by oschwaldio.github.oschwald/maxminddbv0.4.0

Query local MaxMind DB files for IP geolocation, ASN data, and filtered network analysis, with database downloads and automatic updates.

1Dockerstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of MaxMindDB, from the data

MaxMindDB is a database MCP server from oschwald, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

With 1 GitHub stars it ranks #538 of 1,397 database servers we index.

It runs locally on your machine over stdio and needs one secret (MAXMINDDB_MCP_LICENSE_KEY); use a scoped, least-privilege key.

Install MaxMindDB MCP server

claude mcp add maxminddb -e MAXMINDDB_MCP_ACCOUNT_ID='<maxminddb-mcp-account-id>' -e 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.2.0

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "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.2.0"
      ],
      "env": {
        "MAXMINDDB_MCP_ACCOUNT_ID": "<maxminddb-mcp-account-id>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<maxminddb-mcp-license-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MAXMINDDB_MCP_DOWNLOAD_ENABLED	—	—
MAXMINDDB_MCP_DATABASE_DIR	—	—
MAXMINDDB_MCP_ACCOUNT_ID	yes	—	Your MaxMind account ID.
MAXMINDDB_MCP_LICENSE_KEY	yes	yes	A MaxMind license key with access to the selected editions.
MAXMINDDB_MCP_EDITIONS	—	—	Comma-separated edition IDs available to your account.

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
2026-10-18 · today · GitHub
Latest release
2026-10-18 · today · GitHub · v0.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-18 · today · official registry · v0.4.0

How it compares in Database

Against the most-starred database servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
MaxMindDB (this)	1	—	not measured	—	local
Screenpipe	21,982	—	not measured	Active	—
Genai Toolbox	16,679	—	not measured	Active	hosted
Convex Backend	12,716	—	not measured	Active	—
Kubeshark	12,100	—	not measured	Active	local
Baserow	6,174	—	not measured	Active	—

All database MCP servers

FAQ

›How do I install the MaxMindDB MCP server in Claude Code?

Run: claude mcp add maxminddb -e MAXMINDDB_MCP_ACCOUNT_ID='<maxminddb-mcp-account-id>' -e 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.2.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MaxMindDB require an API key?

Yes. It expects MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY, of which 1 is a secret.

›Can I use MaxMindDB as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MaxMindDB in the official MCP registry?

Yes, as io.github.oschwald/maxminddb.

Sources and method

Official MCP Registry entry: updated 2026-10-18
GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.