IPLocate

IPLocate.io の IP アドレスの位置情報とネットワークデータを取得する MCP サーバー

IPLocate.io 用の MCP（Model Context Protocol）サーバーです。位置情報、ネットワーク情報、プライバシー検出、不正利用に関する連絡先など、IP アドレスに関する包括的な情報を提供します。

機能

この MCP サーバーは、IP アドレスの詳細情報を調べるツールを提供します。

• 位置情報：国、都市、座標、タイムゾーン、郵便番号など
• ネットワーク情報：ASN 名、番号、種類、ネットワーク範囲、ISP 情報
• プライバシーとセキュリティ：VPN 検出、プロキシ検出、Tor の出口ノード、ホスティングプロバイダー
• 企業データ：組織名、ドメイン、事業の種類
• 不正利用に関する連絡先：悪意のある活動を報告するためのメールアドレス、電話番号、住所

要件

クイックスタートのセットアップ手順に従うには、次のものが必要です。

• Node.js 18 以降
• npm
• 互換性のある MCP クライアント。例：Cursor、Claude Desktop。

クイックスタート

この MCP サーバーを使う最も簡単な方法は、MCP クライアントを利用することです。以下のセットアップ手順に従って、クライアントを設定してください。

MCP クライアントの設定

Cursor

ワンクリックでセットアップ：

手動で設定：

1. プロジェクトディレクトリで設定を作成します。

   mkdir -p .cursor
   touch .cursor/mcp.json
   

2. .cursor/mcp.json に以下を追加します。

   {
     "mcpServers": {
       "iplocate": {
         "command": "npx",
         "args": ["-y", "@iplocate/mcp-server"],
         "env": {
           "IPLOCATE_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

   your_api_key_here を、IPLocate.io で取得した実際の API キーに置き換えてください。

Claude Desktop

1. Claude Desktop の設定を開きます。

   • macOS の場合：Cmd + ,
   • Windows の場合：Ctrl + ,

2. 「Developer」タブに移動し、「Edit Config」をクリックします。

3. IPLocate サーバーの設定を追加します。

   {
     "mcpServers": {
       "iplocate": {
         "command": "npx",
         "args": ["-y", "@iplocate/mcp-server"],
         "env": {
           "IPLOCATE_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

   your_api_key_here を、IPLocate.io で取得した実際の API キーに置き換えてください。

VS Code（プレビュー）

1. VS Code の MCP 設定を作成します。

   mkdir -p .vscode
   touch .vscode/mcp.json
   

2. .vscode/mcp.json に以下を追加します。

   {
     "servers": {
       "iplocate": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "@iplocate/mcp-server"],
         "env": {
           "IPLOCATE_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

   your_api_key_here を、IPLocate.io で取得した実際の API キーに置き換えてください。

利用可能なツール

サーバーは次のツールを提供します。

lookup_ip_address_details

IP アドレスについて、利用可能なすべてのデータを含む包括的な情報を取得します。

パラメーター：

• ip（任意）：検索する IPv4 または IPv6 アドレスです。指定しない場合は、呼び出し元の IP アドレスに関する情報を返します。

例：

{
  "ip": "8.8.8.8"
}

戻り値： 位置情報、ネットワーク情報、プライバシー、企業データなど、IP アドレスに関する利用可能なすべてのデータです。

lookup_ip_address_location

IP アドレスの地理的位置情報を取得します。

パラメーター：

• ip（任意）：検索する IPv4 または IPv6 アドレスです。

戻り値： 国、都市、座標、タイムゾーン、郵便番号などです。

lookup_ip_address_privacy

IP アドレスが VPN、プロキシ、その他の匿名化サービスとして検出されているか、不正利用ブロックリストに登録されているか、またはホスティングプロバイダーであるかを確認します。

パラメーター：

• ip（任意）：検索する IPv4 または IPv6 アドレスです。

戻り値： VPN の状態、プロキシの検出結果、Tor の出口ノードの状態、ホスティングプロバイダーの情報です。

lookup_ip_address_network

IP アドレスのネットワークおよび ASN（自律システム番号）情報を取得します。

パラメーター：

• ip（任意）：検索する IPv4 または IPv6 アドレスです。

戻り値： ASN の詳細、ネットワーク範囲、ISP 情報、地域レジストリです。

lookup_ip_address_company

IP アドレスの企業／組織情報を取得します。

パラメーター：

• ip（省略可能）：検索する IPv4 または IPv6 アドレスです。

戻り値： 企業名、ドメイン、国、組織の種類です。

lookup_ip_address_abuse_contacts

悪意のある活動を報告するため、IP アドレスの不正利用に関する連絡先情報を取得します。

パラメーター：

• ip（省略可能）：検索する IPv4 または IPv6 アドレスです。

戻り値： 不正利用に関する連絡先のメールアドレス、電話番号、住所、ネットワーク範囲です。

利用可能なプロンプト

このサーバーは、一般的な IP 分析タスクに役立つ、事前設定済みのプロンプトも提供します。

check_ip_security

VPN、プロキシ、Tor の使用状況や不正利用の履歴など、セキュリティ上の懸念点について IP アドレスを分析します。

使用例：「check_ip_security プロンプトを使用して、192.168.1.1 を分析してください」

locate_ip_geographically

IP アドレスの詳細な地理情報を取得します。

使用例：「locate_ip_geographically プロンプトを使用して、自分の現在地を調べてください」

investigate_ip_ownership

IP アドレスの所有者と運用者に関する詳細情報を取得します。

使用例：「investigate_ip_ownership プロンプトを使用して、8.8.8.8 の所有者を確認してください」

ip_comparison

2 つの IP アドレス間で地理情報とネットワーク情報を比較します。

使用例：「ip_comparison プロンプトを使用して、1.1.1.1 と 8.8.8.8 を比較してください」

API キーを追加する

API キーがなくても、1 日あたり最大 50 件のリクエストを送信できます。

IPLocate.io で無料の API キーを登録すると、無料の利用上限が1 日あたり 1,000 件のリクエストに増えます。

無料の API キーを登録する

1. https://iplocate.io/signup にアクセスします
2. 無料アカウントを作成します
3. ダッシュボードから API キーを取得します

このサーバーで API キーを使用する

サーバーは IPLOCATE_API_KEY 環境変数から API キーを自動的に読み取ります。MCP クライアントの設定（上記の設定例を参照）で設定するか、手動で実行する際に指定してください。

サーバーを手動で実行する

開発やテストのためにサーバーを手動で実行する必要がある場合は、いくつかの方法があります。

前提条件

• Node.js 18 以降
• npm または yarn

npx を使用する（推奨）

npx -y @iplocate/mcp-server

API キーを使用する場合：

macOS/Linux の場合：

export IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

Windows の場合：

set IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

npm からインストールする

npm install -g @iplocate/mcp-server
mcp-server-iplocate

ソースからインストールする

git clone https://github.com/iplocate/mcp-server-iplocate.git
cd mcp-server-iplocate
yarn install
yarn build
yarn start

自動再読み込みを使用した開発の場合：

yarn dev

テスト

MCP Inspector を使用してサーバーをテストできます。

npx @modelcontextprotocol/inspector node dist/index.js

API のレスポンス形式

IPLocate API は、IP アドレスに関する包括的なデータを返します。レスポンス構造の例を以下に示します。

{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "city": "Mountain View",
  "latitude": 37.386,
  "longitude": -122.0838,
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com"
  },
  "privacy": {
    "is_vpn": false,
    "is_proxy": false,
    "is_tor": false,
    "is_hosting": true
  }
  // ... and more fields
}

詳細については、IPLocate API のドキュメントを参照してください。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

サポート

• この MCP サーバーに関する問題については、GitHub でイシューを作成してください
• IPLocate API のサポートについては、[email protected] にお問い合わせください
• IPLocate API のドキュメントについては、https://iplocate.io/docs をご覧ください

謝辞

• MCP 仕様については、Model Context Protocol に感謝します
• MCP TypeScript SDK については、Anthropic に感謝します

IPLocate.io について

2017 年以来、IPLocate は最も信頼性が高く正確な IP アドレスデータの提供を目指してきました。

50TB 以上のデータを処理し、包括的な IP ジオロケーション、IP アドレスと企業の対応情報、プロキシおよび VPN の検出、ホスティングの検出、ASN、WHOIS のデータセットを作成しています。当社の API は、数千の企業や開発者向けに、月間 150 億件を超えるリクエストを処理しています。

• メールアドレス：[email protected]
• ウェブサイト：iplocate.io
• ドキュメント：iplocate.io/docs
• 無料の API キーを登録：iplocate.io/signup