IP2Location.io

公式

IP2Location.io APIを統合して、IPアドレスの地理位置情報を取得します。

GitHub

IP2 Location Io MCPで何ができますか？

IP地理位置の検索 — get_geolocationを使用して、任意のIPv4またはIPv6アドレスの国、都市、座標、タイムゾーン、郵便番号、ISPを取得します。
複数IPの一括クエリ — カンマまたはスペースで区切った複数のIPアドレスを渡すことで、1回のリクエストですべての地理位置データを取得できます。
ネットワークとプロキシ情報の確認 — IPアドレスに関連するASN、ドメイン、ネット速度、プロキシタイプ、プロキシプロバイダー情報を取得します。
モバイルキャリアデータの取得 — IPに対して利用可能な場合、MNC、MCC、モバイルブランドを取得します。

ドキュメント

IP2Location.io MCPサーバー

これは、IP2Location.io APIのためのシンプルなモデルコンテキストプロトコル（MCP）サーバー実装です。指定されたIPv4またはIPv6アドレスに関する詳細なジオロケーション情報を返します。

機能

包括的なジオロケーションデータ: 国、地域、市区町村、緯度、経度、郵便番号、タイムゾーンなど、幅広い情報を取得します。
ネットワーク詳細: ASN、ISP、ドメイン、ネットワーク速度などのネットワーク関連データを提供します。
セキュリティインサイト: プロキシタイプやプロバイダーを含むプロキシ情報を検出します。
シンプルな統合: FastMCP ツールとして構築されており、互換性のあるシステムへの容易な統合を可能にします。
非同期: ノンブロッキングな非同期APIリクエストに httpx を利用します。

要件

このMCPサーバーは、APIキーなしでのクエリをサポートしており、1日あたり1,000クエリの制限があります。また、無料のAPIキーにサインアップすると、月間最大50,000クエリを利用できます。

クラウドホスト型MCPサーバーを使用する場合、サーバーはリモートでホストされるため、Claude Desktopと npx のみが必要です。オリジナルのMCPサーバーをローカルで実行する場合、ローカルセットアップでは uv を使用します。これはガイドに従ってインストールできます。

セットアップ

このMCPサーバーは、以下のいずれかの方法でClaude Desktopで使用できます。

クラウドホスト型MCPサーバー: ホストされているIP2Location.io MCPサーバーに直接接続する場合に推奨されます。
ローカルMCPサーバー: オリジナルのMCPサーバーを自身のマシンにダウンロードして実行する場合に使用します。

オプション1: クラウドホスト型MCPサーバー

以下の手順に従って、クラウドホスト型のIP2Location.io MCPサーバーをClaude Desktopで使用します。

Claude Desktopがインストールされていることを確認してください。まだインストールしていない場合は、WindowsおよびmacOSの場合はこちらからダウンロードするか、Linuxユーザーの場合はこのガイドに従ってください。
任意のエディタで claude_desktop_config.json ファイルを開きます。まだファイルがない場合は、このガイドに従って作成してください。
claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

YOUR_API_KEY を実際のIP2Location.io APIキーに置き換えます。APIキーを取得するには、ダッシュボードにログインしてください。
変更を保存した後、Claude Desktopを再起動すると、Connectors メニューにMCPサーバーが表示されます。

オプション2: ローカルMCPサーバー

オリジナルのMCPサーバーをClaude Desktopでローカルに実行する場合は、以下の手順に従ってください。

uv パッケージマネージャーをセットアップします。ガイドを参照してください。
Claude Desktopがインストールされていることを確認してください。まだインストールしていない場合は、WindowsおよびmacOSの場合はこちらからダウンロードするか、Linuxユーザーの場合はこのガイドに従ってください。
任意のエディタで claude_desktop_config.json ファイルを開きます。まだファイルがない場合は、このガイドに従って作成してください。
claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

APIキーを取得するには、ダッシュボードにログインしてください。上記の例の <YOUR API key HERE> を実際のAPIキーに置き換えます。
変更を保存した後、Claude Desktopを再起動すると、Connectors メニューに表示されます。

使用方法

Claude DesktopのチャットでIPに関するクエリを入力するだけです。クエリの例としては、以下のようなものがあります。

(IP)の場所はどこですか？
(IP)はどこにありますか？
(IP)の座標は何ですか？

例えば、以下はIP 8.8.8.8の結果です。

The output of the IP 8.8.8.8

Claude Desktopでは、IP2Location.io MCPサーバーから返された結果に基づいて、モデルが自動的に出力を生成します。

IP2Location.io一括IPジオロケーションAPIを利用して、複数のIPアドレスをクエリすることもできます。各IPアドレスをスペースで区切って入力するだけです。例: 8.8.8.8 8.8.6.6。

[!NOTE]
IP2Location.io一括IPジオロケーションAPIを利用するには、有料プランが必要です。

環境変数

IP2LOCATION_API_KEY

IP2Location.io APIキー。月間最大50,000クエリと、IPアドレスのより詳細な情報を取得できます。無料のAPIキーにサインアップするか、サブスクライブしてプランに加入することで、より多くの特典を享受できます。

ツール

get_geolocation

説明指定されたIPアドレスまたはIPアドレスのバッチのジオロケーションを取得します。ユーザーは、任意のIPv4またはIPv6アドレスについて、国、地域、市区町村、緯度、経度、郵便番号、タイムゾーン、ASN、プロキシ情報などの詳細情報を取得できます。複数のIPが検出された場合、効率的な処理のためにIP2Location.io一括APIに自動的にリクエストをルーティングします。

引数

ip (str): 分析するIPアドレス（IPv4またはIPv6）。カンマ、スペース、または改行で区切られた単一の文字列として渡すことで、一度に複数のIPをクエリできます（例: "1.1.1.1, 2.2.2.2"）。

戻り値 ジオロケーションデータを含むJSON文字列。複数のIPがクエリされた場合、各IPアドレスがそれぞれのデータにマッピングされたJSONオブジェクトを返します。結果には、APIプランに応じて以下のフィールドが含まれる場合があります。

場所と地理: 国、地域、地区、市区町村、郵便番号、緯度と経度、タイムゾーン。
ネットワークと接続性: ASN（自律システム番号）、ISP（インターネットサービスプロバイダー）、ドメイン、ネット速度、IDDコード、市外局番、アドレスタイプ、使用タイプ。
モバイル情報: MNC（モバイルネットワークコード）、MCC（モバイル国コード）、モバイルブランド。
通貨と言語: 通貨コード、通貨名、通貨記号、言語コード、言語名。
プロキシとセキュリティ: プロキシタイプ、最終確認日時、脅威レベル/タイプ、プロキシプロバイダー、詐欺スコア。
その他: IABカテゴリ、天気、標高、人口など。

単一のIPリクエストが失敗した場合、またはIPが無効な場合、ツールはエラーメッセージを文字列として返します。一括リクエストの場合、個々の失敗したIPは、バッチ全体を失敗させることなく、その特定のIPアドレスにマッピングされたエラーオブジェクトを返します。

ライセンス

LICENSEファイルを参照してください。