mcpField
G
geolocation-mcp

geolocation-mcp

ローカル
github.com/7mza地図・旅行03 週間前に更新
リポジトリ

geolocation-mcp について

geolocation-mcpは、最新のIP位置情報を取得するMCPサーバーです。単一・一括検索に対応し、ネットワークやプライバシー関連の情報も返します。

主な機能

  1. 01単一IPの検索
  2. 02IPの一括検索
  3. 03位置とタイムゾーン情報
  4. 04ASNとネットワーク情報
  5. 05VPN・Tor・データセンターの判定

活用シーン

  1. 01IPアドレスの位置確認
  2. 02記録へのネットワーク情報の追加
  3. 03VPNやTorに関連するIPの確認

MCP 対応

MCPクライアント向けに、単一検索用の`getGeoLocationData`と一括検索用の`getGeoLocationDataBulk`ツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "7mza-geolocation": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "7mza/geolocation-mcp:0.0.1"
      ]
    }
  }
}
起動コマンドdocker run -i --rm 7mza/geolocation-mcp:0.0.1

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
oci7mza/geolocation-mcp:0.0.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

GeoLocation MCP サーバー

Coverage

LLM 向けの高速で最新の IP ジオロケーションデータ

デモ

demo

パブリック IPv4 / IPv6 アドレス向け：

  • フラグ：isDatacenter、isTorExitNode、isVPN
  • 市区町村名、地域 ISO コード、緯度／経度、精度半径、郵便番号、タイムゾーン
  • 国名、ISO コード、EU 加盟状況／GDPR
  • ASN 番号、ISP／組織名、ネットワーク CIDR

MCP ツール

ツール説明
getGeoLocationData単一 IP の検索
getGeoLocationDataBulk一括検索。失敗した IP がほかの検索を妨げません

データソース

データソース更新
市区町村／ASNGeoLite2（P3TERX/GeoLite.mmdb 経由）起動時、ファイルがない場合
Tor 出口ノードTor Project毎日
VPN／データセンターの範囲X4BNet/lists_vpn毎日

使い方

# named volume so DBs persist across restarts
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

または compose を使う場合

services:
  geolocation-mcp:
    image: 7mza/geolocation-mcp:latest
    ports:
      - '8891:8080'
    restart: unless-stopped
    volumes:
      - geolocation_data:/home/nonroot/.geolocation-mcp
volumes:
  geolocation_data:
    name: geolocation_data

LLM を接続します：

# example for claude
claude mcp add --transport http geolocation http://localhost:8891/mcp

MCP inspector でテストします：

npm i && npm run mcp
# transport: streamable
# url: http://localhost:8891/mcp

ソースからビルドする

SDKMAN と nvm が必要です。

nvm use && npm i && sdk env install

JVM：

./gradlew clean ktlintFormat ktlintCheck build
./gradlew bootRun

ネイティブ：

./gradlew clean ktlintFormat ktlintCheck build -PgenerateMetadata
./gradlew buildImage
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

ライセンス

GeoLite2 DB は GeoLite2 EULA の適用対象です。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。