Maxminddb MCP

Claude Desktopの設定ファイルに追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "maxminddb": {
      "command": "maxminddb-mcp",
      "env": {
        "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
      }
    }
  }
}

既存のGeoIP.confを使用する場合：

{
  "mcpServers": {
    "maxminddb": {
      "command": "maxminddb-mcp"
    }
  }
}

Claude Code CLIにMCPサーバーを追加します：

claude mcp add maxminddb maxminddb-mcp

カスタム設定を使用する場合：

MAXMINDDB_MCP_CONFIG=/path/to/config.toml claude chat

Claude Code拡張機能をインストールし、VS Codeの設定に追加します：

{
  "claude.mcpServers": {
    "maxminddb": {
      "command": "maxminddb-mcp",
      "env": {
        "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
      }
    }
  }
}

Continue拡張機能をインストールし、Continueの設定（~/.continue/config.json）に追加します：

{
  "mcpServers": [
    {
      "name": "maxminddb",
      "command": "maxminddb-mcp",
      "env": {
        "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
      }
    }
  ]
}

Zedの設定（~/.config/zed/settings.json）に追加します：

{
  "assistant": {
    "mcp_servers": [
      {
        "name": "maxminddb",
        "command": "maxminddb-mcp",
        "env": {
          "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
        }
      }
    ]
  }
}

Clineをインストールし、VS Codeの設定に追加します：

{
  "cline.mcpServers": {
    "maxminddb": {
      "command": "maxminddb-mcp",
      "env": {
        "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
      }
    }
  }
}

Gemini CLIの設定に追加します：

{
  "mcpServers": {
    "maxminddb": {
      "command": "maxminddb-mcp",
      "env": {
        "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
      }
    }
  }
}

詳細については、Gemini CLI MCPガイドを参照してください。

Codexの設定ファイルに追加します：

[mcp_servers.maxminddb]
command = "maxminddb-mcp"
env = { MAXMINDDB_MCP_CONFIG = "/path/to/your/config.toml" }

または、カスタム設定を使用しない場合：

[mcp_servers.maxminddb]
command = "maxminddb-mcp"

Codyの設定に追加します：

{
  "cody.experimental.mcp": {
    "servers": {
      "maxminddb": {
        "command": "maxminddb-mcp",
        "env": {
          "MAXMINDDB_MCP_CONFIG": "/path/to/your/config.toml"
        }
      }
    }
  }
}

LLMツールをインストールし、MCPを設定します：

# LLMをインストール
pip install llm

# MCPサーバーを設定
llm mcp install maxminddb-mcp --command maxminddb-mcp

# 環境変数を使用して実行
MAXMINDDB_MCP_CONFIG=/path/to/config.toml llm chat -m claude-3.5-sonnet

pip install mcp

from mcp import ClientSession, StdioServerParameters

async with ClientSession(
    StdioServerParameters(
        command="maxminddb-mcp",
        env={"MAXMINDDB_MCP_CONFIG": "/path/to/config.toml"}
    )
) as session:
    await session.initialize()
    tools = await session.list_tools()
    result = await session.call_tool("lookup_ip", {"ip": "8.8.8.8"})

npm install @modelcontextprotocol/sdk

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "maxminddb-mcp",
  env: { MAXMINDDB_MCP_CONFIG: "/path/to/config.toml" },
});

const client = new Client(
  {
    name: "maxminddb-client",
    version: "1.0.0",
  },
  { capabilities: {} }
);

await client.connect(transport);
const result = await client.callTool({
  name: "lookup_ip",
  arguments: { ip: "8.8.8.8" },
});

go get github.com/mark3labs/mcp-go

import (
    "github.com/mark3labs/mcp-go/client"
    "github.com/mark3labs/mcp-go/transport/stdio"
)

cmd := exec.Command("maxminddb-mcp")
cmd.Env = append(cmd.Env, "MAXMINDDB_MCP_CONFIG=/path/to/config.toml")

transport := stdio.NewTransport(cmd)
mcpClient := client.New(transport)
// ... use client

JSON-RPCを使用してサーバーを直接テストします：

# 利用可能なツールをリストする
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | maxminddb-mcp

# IPルックアップをテストする
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"lookup_ip","arguments":{"ip":"8.8.8.8"}}}' | maxminddb-mcp

# jqを使用して整形した出力を表示する
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | maxminddb-mcp | jq .

# 動作モード: "maxmind", "directory", または "geoip_compat"
mode = "maxmind"

# 自動更新設定
auto_update = true
update_interval = "24h"

# イテレータ設定
iterator_ttl = "10m"
iterator_cleanup_interval = "1m"

# ロギング（オプション）
log_level = "info"  # debug, info, warn, error
log_format = "text" # text, json

[maxmind]
# MaxMindアカウントの資格情報
account_id = 123456
license_key = "your_license_key_here"

# ダウンロードするデータベース
editions = [
    "GeoLite2-City",
    "GeoLite2-Country",
    "GeoLite2-ASN",
    "GeoIP2-City",
    "GeoIP2-Country"
]

# 保存先
database_dir = "~/.cache/maxminddb-mcp/databases"

# カスタムエンドポイント（オプション）
# endpoint = "https://updates.maxmind.com"

[directory]
# ディレクトリモードの場合 - MMDBファイルをスキャンするパス
paths = [
    "/path/to/mmdb/files",
    "/another/path"
]

[geoip_compat]
# GeoIP.conf互換モードの場合
config_path = "/etc/GeoIP.conf"
database_dir = "/var/lib/GeoIP"

サーバーは自動的に既存のGeoIP.confファイルを検出し、使用します：

# 例: GeoIP.conf
AccountID 123456
LicenseKey your_license_key_here
EditionIDs GeoLite2-Country GeoLite2-City GeoLite2-ASN
DatabaseDirectory /var/lib/GeoIP

追加の設定は必要ありません - サーバーは自動的に互換モードを使用します。

国でフィルタリングする：

{
  "name": "lookup_network",
  "arguments": {
    "network": "10.0.0.0/8",
    "filters": [
      {
        "field": "country.iso_code",
        "operator": "in",
        "value": ["US", "CA", "MX"]
      }
    ]
  }
}

住宅用IPをフィルタリングする：

{
  "name": "lookup_network",
  "arguments": {
    "network": "192.168.0.0/16",
    "filters": [
      {
        "field": "traits.user_type",
        "operator": "equals",
        "value": "residential"
      }
    ]
  }
}

一般的な間違いとバリデーション

• フィルタを"traits.user_type=residential"のような文字列として渡さないでください。サーバーはこれを拒否し、オブジェクトを使用するようにヒントを表示します：{ "field": "traits.user_type", "operator": "equals", "value": "residential" }。
• filtersはオブジェクトの配列である必要があります。他のタイプは無効です。
• operatorはサポートされているものである必要があります（以下のリストを参照）。短いエイリアス（eq、ne、gt、gte、lt、lte）も受け付けられます。

複雑なフィルタリング（非プロキシIP）：

{
  "name": "lookup_network",
  "arguments": {
    "network": "10.0.0.0/24",
    "filters": [
      {
        "field": "traits.is_anonymous_proxy",
        "operator": "equals",
        "value": false
      },
      {
        "field": "traits.is_satellite_provider",
        "operator": "equals",
        "value": false
      }
    ],
    "filter_mode": "and"
  }
}

TOML設定で自動更新を構成します：

auto_update = true
update_interval = "24h"  # 24時間ごとにチェックする

サーバーは以下のことを行います：

• 指定された間隔でデータベースの更新をチェックします
• MD5チェックサムが変更された場合のみダウンロードします
• アクティブなクエリを中断せずにデータベースを正常に再読み込みします
• 更新ステータスとエラーをログに記録します

手動更新： update_databasesツールを使用して即時更新をトリガーします。

ディレクトリモードでは、サーバーはファイルシステムの変更を監視します：

mode = "directory"

[directory]
paths = ["/path/to/mmdb/files"]

サポートされているイベント：

• 作成：新しいMMDBファイルを自動的に読み込みます
• 書き込み：変更されたデータベースを再読み込みします
• 削除：利用可能なリストからデータベースを削除します
• 名前変更：ファイルの名前変更を正常に処理します

サブディレクトリのサポート：すべてのサブディレクトリを再帰的に監視して、MMDBファイルを検出します。

設定を確認する：

# 設定ファイルの構文を検証する
maxminddb-mcp --help

# 設定の読み込みをテストする
MAXMINDDB_MCP_LOG_LEVEL=debug maxminddb-mcp

一般的な原因：

• 設定ファイルのTOML構文が無効です
• MaxMindの資格情報が不足しています
• ファイルのパーミッションが不十分です
• データベースディレクトリのパスが無効です

データベースのステータスを確認する：

# デバッグログを有効にする
MAXMINDDB_MCP_LOG_LEVEL=debug maxminddb-mcp

一般的な原因：

• MMDBファイルが破損しています（ファイルの整合性を確認してください）
• ダウンロードに必要なディスクスペースが不足しています
• updates.maxmind.comへのネットワーク接続に問題があります
• MaxMindのサブスクリプションが期限切れです

サーバーのパスを確認する：

# サーバーがPATHに含まれていることを確認する
which maxminddb-mcp

# サーバーを直接テストする
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | maxminddb-mcp

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json