MCP Ip2location Io

🚀 IP2Location.io MCPサーバー

これは、IP2Location.io API用のシンプルなモデルコンテキストプロトコル（MCP）サーバーの実装です。与えられた任意のIPv4またはIPv6アドレスに対して、詳細な地理的位置情報を返します。

✨ 主な機能

• 包括的な地理的位置データ：国、地域、都市、緯度、経度、郵便番号、タイムゾーンなど、幅広い情報を取得します。
• ネットワーク詳細：ASN、ISP、ドメイン、ネットワーク速度などのネットワーク関連のデータを提供します。
• セキュリティインサイト：プロキシタイプやプロバイダーなどのプロキシ情報を検出します。
• 簡単な統合：FastMCPツールとして構築されており、互換性のあるシステムに簡単に統合できます。
• 非同期処理：httpxを使用して、非ブロッキングの非同期APIリクエストを行います。

📦 インストール

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

セットアップにはuvも使用します。これはガイドに従ってインストールできます。

💻 使用例

クロードデスクトップでの使用方法

以下の手順に従って、このMCPサーバーをクロードデスクトップで使用します。

1. リポジトリをローカルにダウンロードします。
2. uvパッケージマネージャーをセットアップします。再度ガイドを参照して行うことができます。
3. クロードデスクトップがインストールされていることを確認します。インストールされていない場合は、WindowsとMacOSユーザーはこちらからダウンロードし、Linuxユーザーはこのガイドに従ってください。
4. 任意のエディタでclaude_desktop_config.jsonを開きます。まだ持っていない場合は、このガイドに従って作成してください。
5. claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

6. /path/to/ip2locationioのパスを、ローカルのIP2Location.io MCPサーバーの実際のパスに置き換えてください。
7. APIキーを取得するには、ログインしてダッシュボードから取得し、上記の<YOUR API key HERE>を実際のAPIキーに置き換えてください。
8. 変更を保存した後、クロードデスクトップを再起動すると、Search and toolsメニューに表示されます。

クエリの例

クロードデスクトップのチャットで、IPに関するクエリを入力するだけです。例えば以下のようなクエリがあります。

• Where is the location of (IP)?
• Where is (IP) located?
• What is the coordinate of (IP)?

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

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

📚 詳細ドキュメント

環境変数

IP2LOCATION_API_KEY

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

ツール

get_geolocation

説明 指定されたIPアドレスの地理的位置を取得します。任意のIPv4またはIPv6アドレスに対して、国、地域、都市、緯度、経度、郵便番号、タイムゾーン、ASN、プロキシ情報などの詳細情報を取得するのに役立ちます。

引数 ip (str): 分析するIPアドレス（IPv4またはIPv6）。

戻り値 地理的位置データを含むJSON文字列。APIプランによっては、以下のフィールドが含まれる場合があります。

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

リクエストが失敗した場合、またはIPアドレスが無効な場合、ツールはエラーメッセージを文字列として返します。

📄 ライセンス

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