mm-geoip-mcp
mm-geoip-mcpは、IPアドレスに基づいて地理情報を取得するためのPythonライブラリです。このツールは、ユーザーの位置情報を特定し、地域に基づいたサービスの提供を可能にします。セキュリティ分析やデータ解析に役立つ機能を備えており、開発者が簡単に統合できるように設計されています。
GitHubスター
1
ユーザー評価
未評価
お気に入り
0
閲覧数
12
フォーク
0
イシュー
2
README
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