mm-geoip-mcp
mm-geoip-mcp is a Python library designed to retrieve geographical information based on IP addresses. This tool enables the identification of user location, facilitating the provision of region-based services. It comes with features that assist in security analysis and data analytics, making it easy for developers to integrate.
GitHub Stars
1
User Rating
Not Rated
Favorites
0
Views
13
Forks
0
Issues
2
mm-geoip-mcp
A minimal MCP (Model Context Protocol) server providing GeoIP lookup and
anonymous IP detection using MaxMind GeoIP2 databases.
Features
- GeoIP Lookup: Returns location and related info for an IP address using the MaxMind GeoIP2 City database.
- Anonymous IP Detection: Detects if an IP is a proxy, VPN, or other anonymizer using the MaxMind GeoIP2 Anonymous IP database.
Requirements
- Python 3.11+
- The following MaxMind database files (for testing, test files are included in
test-data/):GeoIP2-City-Test.mmdbGeoIP2-Anonymous-IP-Test.mmdb
Installation
Clone this repository:
git clone https://github.com/kevcenteno/mm-geoip-mcp.git cd mm-geoip-mcpInstall dependencies using one of the following methods:
- With uv (recommended for speed, uses
uv.lock):uv pip install -r requirements.txt - With pip:
pip install -r requirements.txt - With Poetry:
poetry install
The
uv.lockfile is provided for reproducible installs with uv.- With uv (recommended for speed, uses
Usage
Environment Variables
Optionally configure the paths to the MaxMind database files using environment variables:
CITY_DB_PATH: Path to the GeoIP2 City database file.ANONYMOUS_DB_PATH: Path to the GeoIP2 Anonymous IP database file.
If not set, the server will use the test databases in test-data/.
Running the MCP Server
python main.py
or
uv run main.py
The server will start and expose the following MCP tools:
geoip_lookup(ip: str) -> dict: Performs a GeoIP City lookup on the provided IP address.anonymous_ip_lookup(ip: str) -> dict: Checks if the IP is detected as an anonymizer (proxy/VPN).
License
MIT