🚀 IPLocate.ioのIPアドレスの地理的位置情報とネットワークデータ用のMCPサーバー
このMCP (Model Context Protocol) サーバーは、IPLocate.io のためのもので、IPアドレスの地理的位置情報、ネットワーク情報、プライバシー検出、悪用連絡先など、包括的なIPアドレス情報を提供します。

✨ 主な機能
このMCPサーバーは、IPアドレスに関する詳細情報を検索するツールを提供します。
- 地理的位置情報:国、都市、座標、タイムゾーン、郵便番号など
- ネットワーク情報:ASN名、番号、タイプ、ネットワーク範囲、ISP情報
- プライバシーとセキュリティ:VPN検出、プロキシ検出、Tor出口ノード、ホスティングプロバイダー
- 企業データ:組織名、ドメイン、業種
- 悪用連絡先:悪意のある活動を報告するためのメールアドレス、電話番号、住所
📦 インストール
必要条件
クイックスタートのセットアップ手順を実行するには、以下が必要です。
- Node.js 18以上
- npm
- 互換性のあるMCPクライアント。例えば、Cursor、Claude Desktop。
クイックスタート
このMCPサーバーを使用する最も簡単な方法は、MCPクライアントを通じることです。以下のセットアップ手順でクライアントを構成してください。
MCPクライアントの構成
Cursor
ワンクリックセットアップ:

手動構成:
- プロジェクトディレクトリで構成ファイルを作成します。
mkdir -p .cursor
touch .cursor/mcp.json
.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. [開発者] タブに移動し、[設定を編集] をクリックします。
3. IPLocateサーバーの構成を追加します。
```json
{
"mcpServers": {
"iplocate": {
"command": "npx",
"args": ["-y", "@iplocate/mcp-server"],
"env": {
"IPLOCATE_API_KEY": "your_api_key_here"
}
}
}
}
```
`your_api_key_here` を [IPLocate.io](https://iplocate.io/signup) から取得した実際のAPIキーに置き換えてください。
VS Code (プレビュー)
1. VS CodeのMCP構成ファイルを作成します。
```bash
mkdir -p .vscode
touch .vscode/mcp.json
```
2. `.vscode/mcp.json` に以下を追加します。
```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](https://iplocate.io/signup) から取得した実際の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 (Autonomous System Number) 情報を取得します。
パラメーター:
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日1000回のリクエストに引き上げることができます。
無料のAPIキーを登録する
- https://iplocate.io/signup にアクセスします。
- 無料アカウントを作成します。
- ダッシュボードからAPIキーを取得します。
このサーバーでAPIキーを使用する
サーバーは、IPLOCATE_API_KEY
環境変数からAPIキーを自動的に読み取ります。MCPクライアントの設定で構成するか (上記の構成例を参照)、手動で実行する際に設定してください。
サーバーを手動で実行する
サーバーを手動で実行する必要がある場合 (開発またはテスト用)、いくつかのオプションがあります。
前提条件
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
}
}
詳細については、IPLocate APIドキュメント を参照してください。
🤝 コントリビューション
コントリビューションは大歓迎です!プルリクエストを送信してください。
📄 ライセンス
このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。
🛠️ サポート
🙏 謝辞
🌐 IPLocate.ioについて
2017年以来、IPLocateは最も信頼性が高く正確なIPアドレスデータを提供することを目指しています。
私たちは50TB以上のデータを処理して、包括的なIP地理的位置情報、IPから企業への変換、プロキシおよびVPN検出、ホスティング検出、ASN、およびWHOISデータセットを生成しています。当社のAPIは、数千の企業や開発者に対して月に150億回以上のリクエストを処理しています。