MaxMindDB

Name: MaxMindDB
Author: oschwald

ローカル

github.com/oschwald地図・旅行11 週間前に更新

リポジトリ

MaxMindDB について

MaxMindDBは、GeoIP2、GeoLite2、カスタムMMDBデータベースからIPの位置情報やネットワーク所有者を調べるローカルMCPサーバーです。MCP対応アシスタント向けに、ネットワーク検索やデータベースの比較、確認、ダウンロードを提供します。

主な機能

01IPの位置情報とASNの検索
02ネットワークの検索と要約
03データベースの比較と確認
04データベースのダウンロードと更新

活用シーン

01IPの国とASNの特定
02ASNに属するネットワークの検索
03利用可能なデータベースと作成日の確認

MCP 対応

MCPクライアントに、IP検索、ネットワーク検索、データベースの比較・確認、インストールや更新のツールを提供します。

設定

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

mcp.json · 共通設定

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

起動コマンド

docker run -i --rm -e MAXMINDDB_MCP_DOWNLOAD_ENABLED -e MAXMINDDB_MCP_DATABASE_DIR -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY -e MAXMINDDB_MCP_EDITIONS ghcr.io/oschwald/maxminddb-mcp:0.2.0

設定が必要な環境変数

MAXMINDDB_MCP_DOWNLOAD_ENABLED

MAXMINDDB_MCP_DATABASE_DIR

MAXMINDDB_MCP_ACCOUNT_IDYour MaxMind account ID.

MAXMINDDB_MCP_LICENSE_KEYシークレットA MaxMind license key with access to the selected editions.

MAXMINDDB_MCP_EDITIONSComma-separated edition IDs available to your account.

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

パッケージ

ocighcr.io/oschwald/maxminddb-mcp:0.2.0stdio

ツール

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

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

詳細

MaxMindDB MCP Server

AI アシスタントから、GeoIP2、GeoLite2、カスタム MMDB データベースを使って IP の位置情報やネットワークの所有者を検索できます。 MCP を通じてネットワークを検索し、データベースを比較し、新しいデータベースをダウンロードできます。

これは非公式のプロジェクトであり、MaxMind Inc. の承認を受けていません。公式製品とサポートについては、maxmind.comをご覧ください。

次のように質問してみてください。

「MaxMindDB を使って、8.8.8.8 の国と自律システムを特定してください。」
「私の ASN データベースで、1.0.0.0/8 内にある AS13335 に属するネットワークを見つけてください。」
「利用可能なデータベースと、その構築日時を教えてください。」

回答はお使いのデータベースに基づきます。IP ジオロケーションは推定値であり、デバイスの正確な位置ではありません。 ASN データが示すのはネットワークの所有者であり、そのアドレスを使っている人の身元ではありません。

必要なもの

既存の.mmdbファイル、または利用したいエディションへのアクセス権があるMaxMind アカウント ID とライセンスキーのいずれかを用意してください。データベースと認証情報は同梱されていません。

サーバーはお使いのコンピューター上で実行され、ローカル MCP サーバーに対応するクライアントが必要です。

インストール

Claude Desktop

Claude Desktop からサーバーをインストールして設定できます。ターミナル、Go のインストール、設定ファイルは不要です。

最新の MCPB をダウンロードします。この単一ファイルには、サポート対象のすべてのプラットフォーム向けネイティブビルドが含まれています。
Claude Desktop で設定 → 拡張機能 → 詳細設定 → 拡張機能をインストールを開き、ファイルを選択します。
拡張機能の設定で、データベースの提供方法を選択します。
- データベースをダウンロード： MaxMind アカウント ID とライセンスキーを入力します。デフォルトのエディションはGeoLite2-CityとGeoLite2-ASNです。
- 既存のファイルを使用： MaxMind データベースをダウンロードして更新をオフにし、.mmdbファイルを含むフォルダーを選択します。
拡張機能を有効にして、「MaxMindDB を使って、データベースの一覧を表示し、8.8.8.8 を検索してください」と質問します。

最初のダウンロードはバックグラウンドで実行されます。検索の準備がまだできていない場合は、Claude にデータベースの状態を確認するよう依頼してください。ライセンスキーはチャットではなく、拡張機能の設定に入力してください。

v0.2.0 以前からのアップグレード： 古い拡張機能を削除して新しいものをインストールし、再度設定してください。データベースファイルはそのまま残ります。アップグレード、設定、サポート対象プラットフォームをご覧ください。

スタンドアロン実行ファイル

macOS では、Homebrew を使ってインストールします。

brew install --cask oschwald/tap/maxminddb-mcp

その他のプラットフォーム、または Homebrew を使わない場合は、GitHub Releasesからアーカイブまたは Linux パッケージをダウンロードしてください。インストール方法とチェックサムについては、スタンドアロンのセットアップをご覧ください。次に、サーバーを設定し、以下のクライアントを接続してください。

Go 開発者はソースからビルドすることもできます。

クライアントを接続する

手順に沿って設定するには、クライアントを選択してください。

クライアント	セットアップ要件
ChatGPT デスクトップ	実行ファイルのインストールと設定が必要です。ローカルスレッドのみ
Codex	実行ファイルのインストールが必要です。設定ファイルまたは環境設定が必要です
Claude Code	Universal ネイティブプラグイン、または実行ファイルのインストールと設定が必要です
Antigravity CLI (`agy`)	実行ファイルのインストールと設定が必要です
Zed	実行ファイルのインストールと設定が必要です
Docker	Docker エンジンと、コンテナから読み取り可能な設定ファイルが必要です
ChatGPT デスクトッププラグイン（実験的）	Codex CLI の登録と既存のサーバー設定が必要です。デスクトップ UI では未検証です
Claude Cowork プラグイン（実験的）	Universal プラグイン ZIP が必要です。インストールと設定 UI では未検証です
Cursor プラグイン（未検証）	Docker エンジンが必要です。インストールと設定 UI では未検証です
Gemini CLI（レガシー）	Gemini CLI への継続的なアクセスが必要です。ネイティブ拡張機能でアカウント設定を求められます

設定

Claude Desktop のユーザーは、拡張機能で設定を管理できます。スタンドアロンインストールについては、設定ガイドで次の項目を説明しています。

MaxMind の認証情報を使用したダウンロード。
既存の MMDB フォルダーまたは GeoIP.conf。
環境設定、設定の検出、ログ記録。

セットアップに失敗した場合は、トラブルシューティングから確認してください。

ツール

アシスタントはツールを自動的に検出します。IP の検索、ネットワークの検索や要約、データベースの比較や調査、データベースのインストールや更新を依頼できます。

ツールリファレンスでは、引数、結果、フィルター、ページネーション、制限、エラーについて説明しています。

ヘルプと開発

問題を報告。
コントリビューション：ビルド、テスト、リリースの手順。
変更履歴。

ライセンス

ISC。

Markdown 対応

ログインしてコメント

基本情報

作者: oschwald
バージョン: 0.2.0
トランスポート: stdio
掲載日: 2026年10月17日
最終更新: 1 週間前
公式 Registry: io.github.oschwald/maxminddb-mcp

問題を報告

MCP は初めてですか？

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

入門ガイドを読む

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

MaxMindDB

MaxMindDB について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

MaxMindDB MCP Server

必要なもの

インストール

Claude Desktop

スタンドアロン実行ファイル

クライアントを接続する

設定

ツール

ヘルプと開発

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？