Location Services · Research & Data

Maxminddb MCP logo

Maxminddb MCP

oschwald/maxminddb-mcp

A powerful Model Context Protocol (MCP) server that provides comprehensive geolocation and network intelligence through MaxMindDB databases. Query GeoIP2, GeoLite2, and custom MMDB files with advanced filtering, stateful iteration, and automatic updates.

Install

go install github.com/oschwald/maxminddb-mcp/cmd/maxminddb-mcp@latest

Client configuration

{
  "mcpServers": {
    "maxminddb": {
      "command": "maxminddb-mcp",
      "env": {
        "MAXMINDDB_MCP_CONFIG": "<MAXMINDDB_MCP_CONFIG>"
      }
    }
  }
}

Environment variables

MAXMINDDB_MCP_CONFIGMAXMINDDB_MCP_LOG_LEVELMAXMINDDB_MCP_LOG_FORMAT
Author
@oschwald
Category
Location Services, Research & Data
License
ISC
Updated
Oct 6, 2026

Features

  • Multiple Data Sources: MaxMind accounts, directory scanning, and GeoIP.conf compatibility

  • Advanced Filtering: Query by any MMDB field with 11+ operators (equals, regex, comparisons, etc.)

  • Stateful Iteration: Process large network ranges efficiently with resumable iterators

  • Auto-updating: Automatic database downloads and updates from MaxMind

  • File Watching: Dynamic loading of new/updated database files

  • Flexible Configuration: TOML config with GeoIP.conf fallback support

Tools (26)

  • lookup_ip

    Look up geolocation and network information for a specific IP address.

  • lookup_network

    Query all IP addresses in a network range with powerful filtering capabilities.

  • list_databases

    List all available MaxMind databases with metadata.

  • update_databases

    Manually trigger database updates (MaxMind/GeoIP modes only).

  • equals

    Exact match

  • not_equals

    Not equal to value

  • in

    Value is in provided array

  • not_in

    Value is not in provided array

  • regex

    Matches regular expression

  • greater_than

    Numeric comparison

  • greater_than_or_equal

    Numeric comparison (≥)

  • less_than

    Numeric comparison

  • less_than_or_equal

    Numeric comparison (≤)

  • exists

    Field exists (boolean value)

  • eq

    equals

  • ne

    not_equals

  • gt

    greater_than

  • gte

    greater_than_or_equal

  • lt

    less_than

  • lte

    less_than_or_equal

  • db_not_found

    Specified database does not exist

  • invalid_ip

    IP address format is invalid

  • invalid_network

    Network CIDR format is invalid

  • invalid_filter

    Filter validation failed

  • iterator_not_found

    Iterator ID not found or expired

  • parse_error

    Failed to parse request parameters

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cline logo

Cline

Desktop · Free · MIT

An AI coding assistant integrated into the IDE. Supports MCP servers for enhanced functionality.

WindowsMacOSLinux
Continue logo

Continue

Desktop · Free · Apache 2.0

Open-source autocomplete coding tool for VS Code and JetBrains. Integrates MCP servers to extend AI capabilities.

WindowsMacOSLinux
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
Baidu Map logo

Baidu Map

baidu-maps/mcp

240

Baidu Map MCP Server is a fully MCP-compliant, open-source Location-Based Service (LBS) solution, providing a comprehensive suite of geospatial APIs and tools for developers and AI agents.

Location Services
Open Streetmap MCP logo

Open Streetmap MCP

jagan-shanmugam/open-streetmap-mcp

41

An OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.

Location Services
Awesome MCP Server Cn logo

Awesome MCP Server Cn

LeslieLeung/awesome-mcp-server-cn

39

A curated list of MCP Server resources for common services in China, covering maps, weather, cloud services and more.

Location Services
Google Maps (Travel Planner) logo

Google Maps (Travel Planner)

gongrzhe/travel-planner-mcp-server

37

A Travel Planner Model Context Protocol (MCP) server implementation for interacting with Google Maps and travel planning services. This server enables LLMs to perform travel-related tasks such as location search, place details lookup, and travel time calculations.

Location Services
MCP Server Ipinfo logo

MCP Server Ipinfo

briandconnelly/mcp-server-ipinfo

18

A Model Context Protocol server that exposes the ipinfo.io API to AI agents. Geolocate IPv4 and IPv6 addresses, identify ISPs and ASNs, detect VPN/proxy/Tor exit nodes, and generate interactive maps for sets of IPs.

Location Services
MCP-Geo logo

MCP-Geo

webcoderz/MCP-Geo

16

All dependencies are specified in requirements.txt for easy installation.

Location Services