IPGeolocation.io MCPサーバー

IPGeolocation.ioの公式MCPサーバーです。16種類のMCPツールが含まれています：IPジオロケーション、脅威/VPN/プロキシ検出、タイムゾーン検索と変換、日の出/日の入り/月データ、ASN詳細、不正利用連絡先、ユーザーエージェント解析。7つのツールは無料プラン（1日1,000クレジット）で利用可能です。有料プランでは全16ツールに加え、バルクエンドポイント（1回あたり最大1,000件）が利用可能になります。

Claude Desktop、Cursor、Windsurf、VS Code、Codex、Cline、Glama、その他すべてのMCPクライアントで動作します。

クイックスタート

1. 無料のIPGeolocation APIキーを作成する

2. Cursorユーザーはワンクリックでインストール可能です：

   

3. MCPクライアントの設定に以下を追加します（クライアントごとの正確な設定ファイルパスについては、以下のクライアント別のインストールを参照してください）：

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. クライアントを再起動します。

5. テスト：**「8.8.8.8の場所はどこですか？」**と尋ねてみてください。

目次

• クイックスタート

• クライアント別のインストール

• 動作確認

• プラン別ツール

• ツールリファレンス

• プロンプト例

• 回答例とツール出力

• エラーコード

• 仕組み

• キャッシュ

• 環境変数

• ソースからのビルド

• Docker

• テスト

• トラブルシューティング

• 料金

• リンク

• ライセンス

• プライバシーポリシー

クライアント別のインストール

要件

• Node.js 18以降

• ターミナルでnpxが利用可能であること

• ほとんどのツールでIPGeolocation.io APIキーが必要

get_my_ipはAPIキーなしで動作します。それ以外はすべてAPIキーが必要です。

無料のIPGeolocation APIキーに登録する

Codex CLI

codex mcp add ipgeolocation --env IPGEOLOCATION_API_KEY=<YOUR_API_KEY> -- npx -y ipgeolocation-io-mcp
codex mcp list

サーバーを追加した後、新しいCodexセッションを開始してください。

Claude Desktop

claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Claude Desktopを再起動してください。MCPバンドルをサポートするクライアント向けにmanifest.jsonも提供しています。

Cline

MCP Serversパネル > Configure > Advanced MCP Settingsを開きます。cline_mcp_settings.jsonに追加します：

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Clineを再起動してください。

Cursor

ワンクリックインストール：

または、.cursor/mcp.jsonに手動で追加します：

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Cursorを再起動してください。

Windsurf

~/.codeium/windsurf/mcp_config.jsonに追加します：

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Windsurfを再起動してください。

VS Code / GitHub Copilot

VS Codeのsettings.jsonに追加します：

{
  "mcp": {
    "servers": {
      "ipgeolocation": {
        "command": "npx",
        "args": ["-y", "ipgeolocation-io-mcp"],
        "env": {
          "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

保存後、VS Codeを再起動してください。

Glama

Glamaで直接サーバーを試すことができます。IPGEOLOCATION_API_KEYのみが必要です。キャッシュ、タイムアウト、出力制限を変更する場合を除き、他の環境変数フィールドは空のままにしてください。

まだキーをお持ちでない場合は、無料のIPGeolocation APIキーを作成してください。

その他のMCPクライアント

この設定を使用してください：

{
  "command": "npx",
  "args": ["-y", "ipgeolocation-io-mcp"],
  "env": {
    "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
  }
}

動作確認

セットアップ後に以下を試してください：

プラン別ツール

無料プラン

1日1,000クレジット。以下の7つのツールが利用可能です：

有料プラン

全16ツール。有料プランでは、lookup_ipにnetwork、company、拡張asnフィールドが追加され、さらにsecurity、abuse、hostname、liveHostname、hostnameFallbackLive、user_agent、geo_accuracy、dma_code、または*用のincludeパラメータが利用可能になります。

include付きlookup_ipのクレジット計算：

現在のプラン詳細と料金については、IPGeolocation料金ページを参照してください。

ツールリファレンス

lookup_ip

単一のIPまたはドメインルックアップ。無料および有料。1クレジット。

1つのIPアドレスの場所、タイムゾーン、通貨、またはASNが必要な場合に使用します。有料プランでは、includeモジュールを追加してセキュリティ、不正利用、またはホスト名データを同じ呼び出しで取得でき、追加のリクエストを回避できます。

無料プランは、基本の場所、国のメタデータ、通貨、タイムゾーン、および基本的なASNを返します。有料プランでは、network、company、拡張ASN、およびincludeパラメータが追加されます。ドメインルックアップには有料プランが必要であることに注意してください。

ヒント：includeとfieldsを組み合わせると、クレジットコストを削減できます。例えば、include=security&fields=securityは、基本のジオロケーションレスポンスをスキップするため、3クレジットではなく2クレジットになります。同様に、include=abuse&fields=abuseは2クレジットではなく1クレジットになります。

bulk_lookup_ip

バッチIPルックアップ。有料。1 IPあたり1クレジット。

IPまたはドメインの配列を受け取ります（デフォルトで最大1,000件、IPGEOLOCATION_MCP_MAX_BULK_ITEMSで設定可能）。lookup_ipと同じinclude、fields、excludesオプションをサポートします。

get_my_ip

サーバーを実行しているマシンのパブリックIPを返します。無料。0クレジット。APIキー不要。

パラメータは不要です。常にネットワークにアクセスします（キャッシュされません）。サーバープロセスが起動していることを確認するためのクイックチェックとして便利です。

check_security

1つのIPの脅威および匿名性データ。有料。2クレジット。

脅威スコア、VPN/プロキシ/Torフラグ、プロバイダー名、信頼度スコア、ボット/スパムインジケーター、匿名性フラグ、クラウドプロバイダーステータスを返します。

同じプロンプトで場所、ASN、または不正利用データも必要な場合は、lookup_ipとinclude=securityを使用する方が、1回の呼び出しですべてをバンドルできるため効率的です（個別に2+1ではなく合計3クレジット）。

bulk_security_check

check_securityのバッチバージョン。有料。1 IPあたり2クレジット。