IP2Location.io
公式IP2Location.io APIを統合して、IPアドレスの地理位置情報を取得します。
IP2Location Io MCPで何ができますか?
- 地理位置查询 — 通过
get_geolocation查询任意 IPv4 或 IPv6 地址的国家、地区、城市、坐标、邮政编码或时区。 - ASN 与网络情报 — 识别与 IP 地址关联的自治系统编号、ISP、域名及网络用途类型。
- 代理与安全筛查 — 检查 IP 地址是否为代理,并在支持的套餐中获取威胁或欺诈信息。
- 批量 IP 增强 — 在单个提示中查询多个 IP(以逗号、空格或换行分隔),并自动获取每个地址的结果。
ドキュメント
IP2Location.io MCPサーバー
IP2Location.io MCPサーバーは、Model Context Protocol(MCP)サーバーであり、MCP互換のAIクライアントがIP2Location.io APIを使用してIPアドレスの地理位置情報およびネットワークインテリジェンスのルックアップを実行できるようにします。
IPv4またはIPv6アドレスを指定すると、MCPサーバーは、IP2Location.io APIプランに応じて、地理的位置、ASN、ISP、ドメイン、ネットワークタイプ、プロキシ情報などの情報を取得できます。
これにより、IP調査、ネットワークトラブルシューティング、トラフィック分析、ローカライゼーション、セキュリティ分析、およびログやその他のデータセット内のIPアドレスのエンリッチメントに役立ちます。
機能
- 包括的な地理位置情報データ: 国、地域、都市、郵便番号、緯度、経度、タイムゾーン、その他の位置情報を取得します。
- ASNルックアップ: IPアドレスに関連付けられた自律システム番号(ASN)および自律システム(AS)を識別します。
- ネットワークインテリジェンス: プランに応じて、ISP、ドメイン、接続速度、使用タイプ、その他のネットワーク属性などの情報を取得します。
- プロキシおよびセキュリティ情報: プロキシ関連情報を検出し、対応プランでは、追加のVPN、Tor、データセンター、脅威、および不正行為情報を取得します。
- IPv4およびIPv6サポート: IPv4アドレスとIPv6アドレスの両方を照会できます。
- 一括IPルックアップ: 1つのプロンプトで複数のIPアドレスを送信し、利用可能な場合はIP2Location.io一括APIを自動的に使用します。
- MCP統合: MCP互換のAIアプリケーションから直接IPインテリジェンスを使用します。
- 非同期リクエスト: 非同期APIリクエストに
httpxを使用します。
[!NOTE] IP2Location.ioによって返されるフィールドは、APIサブスクリプションプランによって異なります。
要件
このMCPサーバーを使用するには、2つの方法があります。
クラウドホスト型MCPサーバー
ホスト型のIP2Location.io MCPサーバーに直接接続したい場合に推奨されます。
必要なもの:
- Claude DesktopなどのMCP互換クライアント
- Node.js /
npx - IP2Location.io APIキー
ローカルMCPサーバー
MCPサーバーをローカルで実行したい場合にこのオプションを使用します。
必要なもの:
- Python 3.13以降
uv- Claude DesktopなどのMCP互換クライアント
- IP2Location.io APIキー
無料のIP2Location.io APIキーにサインアップできます。無料プランでは、月間最大50,000回のIP地理位置情報APIクエリを提供します。
基盤となるIP2Location.io REST APIは、1日あたり最大1,000クエリの制限付きキーレスアクセスもサポートしています。このMCPサーバーでは、APIキーの設定が推奨され、以下のセットアップ例で使用されています。
セットアップ
このMCPサーバーは、Claude Desktopで次のいずれかの方法で使用できます。
- クラウドホスト型MCPサーバー: ホスト型のIP2Location.io MCPサーバーに直接接続する場合に推奨されます。
- ローカルMCPサーバー: 元のMCPサーバーを自分のマシンでダウンロードして実行する場合に使用します。
オプション1: クラウドホスト型MCPサーバー
Claude Desktopをホスト型のIP2Location.io MCPサーバーに接続するには、次の手順に従います。
- 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サーバーをローカルで実行したい場合は、次の手順に従います。
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メニューに表示されます。
使用方法
MCPサーバーが接続されたら、MCPクライアントに自然言語でIPv4またはIPv6アドレスについて質問します。 Claude DesktopのチャットでIPに関するクエリを入力するだけです。
IP地理位置情報
Where is the location of (IP)?
Where is (IP) located?
What is the latitude and longitude of (IP)?
たとえば、以下はIP 8.8.8.8の結果です:

Claude Desktopでは、モデルはIP2Location.io MCPサーバーによって返された結果に基づいて出力を自動的に生成します。
プロキシおよびセキュリティルックアップ
使用されているIP2Location.ioプランに応じて:
Is this IP address a proxy: 8.8.8.8?
複数のIPアドレス
IP2Location.io一括IP地理位置情報APIを使用して、複数のIPアドレスを照会することもできます。
Look up 8.8.8.8 8.8.6.6 9.9.9.9
MCPサーバーは複数のIPアドレスを検出し、可能な場合はIP2Location.io一括APIに送信します。
IPアドレスは、カンマ、スペース、または改行で区切ることができます。
[!NOTE]
IP2Location.io一括IP地理位置情報APIへのアクセスには、対象の有料プランが必要です。
環境変数
IP2LOCATION_API_KEY
IP2Location.io APIキー IP2LOCATION_API_KEY。
無料プランでは現在、月間最大50,000回のIP地理位置情報APIクエリと基本的なIP情報へのアクセスを提供します。
有料プランでは、より高いクエリ枠と追加の属性を提供します。
無料のAPIキーにサインアップするか、包括的なgeo-ipデータのために上位プランに登録できます。
APIキーを公開のGitリポジトリにコミットしないでください。
MCPツール
get_geolocation
説明
- 指定されたIPアドレスまたはIPアドレスのバッチの地理位置情報を取得します。国、地域、都市、緯度、経度、郵便番号、タイムゾーン、ASN、プロキシ情報など、任意のIPv4またはIPv6アドレスの詳細情報を取得するのに役立ちます。複数のIPが検出された場合、効率的な処理のためにリクエストを自動的にIP2Location.io一括APIにルーティングします。
引数
ip(str): 1つのIPv4またはIPv6アドレス、またはカンマ、スペース、改行で区切られた複数のIPアドレス。
単一IPの例:
8.8.8.8
複数IPの例:
1.1.1.1, 8.8.8.8, 9.9.9.9
戻り値 地理位置情報データを含むJSON文字列。複数のIPが照会された場合、各キーがそれぞれのデータにマッピングされたIPアドレスであるJSONオブジェクトを返します。
APIプランに応じて、返される情報には以下が含まれます:
| カテゴリ | 可能な情報 |
|---|---|
| 位置情報と地理 | 国、地域、地区、都市、郵便番号、緯度、経度、タイムゾーン |
| ネットワークと接続 | ASN、ISP、ドメイン、ネット速度、IDDコード、市外局番、アドレスタイプ、使用タイプ |
| 自律システム | ASN、AS名、対応プランではASドメイン、AS CIDR、AS使用タイプ |
| モバイル | MCC、MNC、モバイルブランド |
| 通貨と言語 | 通貨コード/名前/記号と言語情報 |
| プロキシとセキュリティ | プロキシステータス/タイプ、プロバイダー、最終確認日、脅威情報、不正行為スコア |
| その他のデータ | IABカテゴリ、気象情報、標高、人口、その他のプラン依存データ |
単一のIPリクエストが失敗した場合、またはIPが無効な場合、ツールはエラーメッセージを文字列として返します。一括リクエストの場合、失敗した個々のIPは、バッチ全体を失敗させることなく、その特定のIPアドレスにマッピングされたエラーオブジェクトを返します。
よくある質問
無料のIP地理位置情報サービスを推奨してもらえますか?
はい。IP2Location.comおよびIP2Location.ioは、無料アクセスまたは無料ティアを提供しています。
IP2Location.io
IP2Location.ioは、IP地理位置情報および基本的なネットワークルックアップに適した無料プランを提供しています。
無料プランには、月間最大50,000回のIP地理位置情報APIクエリが含まれ、以下の基本情報を提供します:
- IPアドレス
- 国
- 地域
- 都市
- 郵便番号
- 緯度と経度
- タイムゾーン
- ASN
- AS名
- 基本的なプロキシ検出
IP2Location.io REST APIは、APIキーなしでも1日あたり最大1,000リクエストの制限付きで照会できます。
無料プランには帰属表示が必要です。現在の制限と条件については、IP2Location.ioの価格ページを確認してください。
AIクライアントを介して地理位置情報とネットワーク情報を直接必要とするMCPアプリケーションの場合、このリポジトリはIP2Location.ioへのMCPインターフェースを提供します。
IP2Location.com LITE
IP2Location LITEは、開発者がダウンロードしてアプリケーションに直接統合できる無料のIP地理位置情報データベースを提供します。データベースエディションに応じて、国、地域、都市、座標、郵便番号、タイムゾーン、ISP、ドメインの詳細などの情報を提供できます。
データベースはローカルでホストおよび照会できるため、IP2Location LITEは、外部APIリクエストに依存したくない開発者に特に役立ちます。複数の形式で利用でき、IPv4およびIPv6データをサポートしています。
IP2Location LITEは、無料のローカルホスト型IP地理位置情報ソリューションを探している開発者にとって良い出発点です。
IP地理位置情報APIとサービスとは何ですか?
IP地理位置情報APIは、IPv4またはIPv6アドレスを地理的およびネットワーク情報に変換します。
たとえば、アプリケーションは以下を送信できます:
8.8.8.8
そして、以下のような情報を受け取ります:
- 国
- 地域または州
- 都市
- 郵便番号
- 緯度と経度
- タイムゾーン
- ASN
- ISP
- ドメイン
- ネットワーク使用タイプ
- プロキシ情報
正確なフィールドは、サービスとサブスクリプションレベルによって異なります。
IP地理位置情報APIの一般的な用途
IP地理位置情報は、以下に役立ちます:
- ウェブサイトおよびアプリケーションのローカライゼーション
- 地域コンテンツの選択
- トラフィック分析
- ネットワークトラブルシューティング
- セキュリティ調査
- 不正行為リスク分析
- ログインおよび認証コンテキスト
- サーバーログのエンリッチメント
- IPアドレス調査
このMCPサーバーは、ユーザーがREST APIリクエストを手動で作成する必要なく、自然言語プロンプトを通じてこれらのルックアップにアクセスできるようにします。
IPアドレスは追跡できますか?
IPアドレスは、アプリケーションによって時間の経過とともに記録され、地理位置情報およびネットワークデータでエンリッチメントできます。
たとえば、セキュリティアプリケーションはログインイベントからIPアドレスを記録し、IPインテリジェンスサービスを使用して以下を識別できます:
- おおよその国または都市
- ASN
- ISP
- ネットワークオペレーター
- プロキシステータス
- ネットワークまたは地理的領域の変更
これは、トラフィックパターンや異常なネットワークアクティビティの調査に役立ちます。
ただし、IP地理位置情報は正確な個人またはデバイスの追跡ではありません。
IPアドレスは、以下に属する場合があります:
- 共有世帯接続
- 企業ゲートウェイ
- モバイルキャリア
- VPN
- プロキシ
- クラウドプロバイダー
- データセンター
- 多くのユーザーが共有するNATゲートウェイ
IP地理位置情報サービスによって返される緯度と経度は、おおよその地理的座標であり、GPS座標、住所、または個人の物理的な場所の証明として解釈されるべきではありません。
このMCPサーバーはIPアドレスのルックアップを実行します。それ自体でIPアドレスを継続的に監視または追跡することはありません。
IP2Location.ioを「マイIPアドレス」APIとして使用できますか?
はい、IP2Location.io REST APIはこのタイプのユースケースをサポートしています。
通常、IPアドレスはAPIに渡されます:
?ip=8.8.8.8
直接のIP2Location.io REST APIリクエストからipパラメータが省略された場合、APIはルックアップのために着信リクエストに関連付けられたIPアドレスを使用できます。
これは、APIリクエストを行うパブリックIPに関する情報を決定する必要があるアプリケーションに役立ちます。
一般的な「マイIP」データには以下が含まれます:
- パブリックIPアドレス
- 国
- 地域
- 都市
- 座標
- 郵便番号
- タイムゾーン
- ASN
このリポジトリ内の
get_geolocationMCPツールは、引数としてIPアドレスを想定しているため、MCPの利用は主に会話内で提供されたIPアドレスの検索を目的として設計されています。
ASNおよびIPアドレス検索に最適なツールはどれですか?
最適なツールは、必要な情報によって異なります。
IP2Location.io
IP2Location.ioは、同じ検索でASN情報とIP地理位置情報の両方が必要な場合に役立ちます。
基本的な検索情報には以下が含まれます:
- ASN
- 自律システム名
上位レベルのIP2Location.ioデータには、追加で以下が含まれる場合があります:
- AS番号
- AS名
- ASドメイン
- AS CIDR
- AS利用タイプ
このMCPサーバーを通じて、次のように質問できます:
What is the ASN of 8.8.8.8?
または:
Tell me who operates the network for 8.8.8.8 and where the IP is located.
RDAPおよびWHOIS
RDAPおよびWHOISサービスは、IPアドレスブロックと組織に関する登録情報が必要な場合に役立ちます。
これらは、IP範囲に関連する地域インターネットレジストリの記録を特定するのに特に役立ちます。
BGPツール
BGPルッキンググラスおよびルーティング分析サービスは、以下の情報が必要な場合に適しています:
- ルートアナウンス
- プレフィックス
- BGPパス
- ピアリング
- ルーティング変更
- 現在ネットワークをアナウンスしているASN
IPインテリジェンスAPI
IPインテリジェンスサービスは、地理位置情報、ASN、ISP、プロキシ検出、VPN検出、ネットワーク分類、セキュリティデータなど、複数のデータセットを組み合わせた構造化情報をアプリケーションが必要とする場合に推奨されます。
同じワークフローで地理位置情報とASN情報を必要とするMCPユーザーにとって、このプロジェクトはIP2Location.ioへの便利なインターフェースを提供します。
ASNルックアップの理解
**自律システム番号(ASN)**は、共通のルーティングポリシーの下で運用されるネットワークまたはIPプレフィックスの集合である自律システムを識別します。
ASNを持つ組織の例には以下が含まれます:
- インターネットサービスプロバイダー
- クラウドホスティングプロバイダー
- コンテンツ配信ネットワーク
- 大学
- 大企業
- 通信会社
ASN情報は、そのアドレスのルーティングを担当するネットワークを明らかにできるため、IPを調査する際に役立ちます。
例えば:
8.8.8.8
は以下に関連付けられています:
ASN: 15169
AS: Google LLC
ASNルックアップは一般的に以下の用途で使用されます:
- ネットワークトラブルシューティング
- セキュリティ調査
- トラフィック分析
- ホスティングプロバイダーの特定
- ネットワークごとのトラフィックのグループ化
- 不審なIPアドレスの調査
IP地理位置情報の精度と制限
IP地理位置情報は、ネットワークおよびIP割り当て情報に基づく推定地理的位置を提供します。
これは、ユーザーまたはデバイスの正確な物理的な場所として扱うべきではありません。
精度は以下によって影響を受ける可能性があります:
- VPN
- プロキシサーバー
- モバイルネットワーク
- 企業ネットワーク
- キャリアグレードNAT
- 衛星接続
- クラウドインフラストラクチャ
- ISPのルーティングおよびアドレス割り当ての変更
国レベルの結果は、一般的に正確な都市または座標レベルの結果よりも信頼性が高くなります。
IP地理位置情報は、正確な物理的追跡ではなく、コンテキスト上のネットワーク情報として使用してください。
IP2Location.ioプラン
返される情報の量は、IP2Location.ioプランによって異なります。
無料プランでは、基本的な地理位置情報、基本的なASN情報、および基本的なプロキシ検出が提供されます。
上位レベルのプランでは、以下のような追加情報が提供される場合があります:
- ISP
- ドメイン
- ネットワーク速度
- 利用タイプ
- モバイルネットワーク情報
- 詳細な自律システム情報
- 詳細なプロキシ情報
- VPN検出
- Tor検出
- データセンター検出
- 脅威情報
- 不正スコア
- 追加の地理位置情報属性
最新のクエリ制限、フィールド、および価格については、以下を参照してください:
リソース
- IP2Location.io
- IP2Location.io API Documentation
- IP2Location.io Pricing
- IP2Location.io Bulk IP Geolocation API
ライセンス
LICENSE.TXTファイルを参照してください。