埃文IP定位 MCP Server

埃文IP位置特定 MCP Server

紹介

埃文科技 は、世界をリードする高精度リアルタイムIPアドレス位置特定技術の提供者であり、グローバルなサイバースペースマップのビッグデータサービスプロバイダーです。

埃文科技のIP位置特定APIは、MCPプロトコルに全面対応しています。

MCP Server for the Aiwen IP Location API

ツール紹介

1. IP位置特定 aiwen_ip_location
   • 説明：IP位置特定。IPアドレスから、IP位置（都市、区・県、街区の3段階の精度に対応）、緯度・経度、所属機関、通信事業者、精度などの情報を取得します。
   • パラメーター： ip：IPアドレス。IPv4、IPv6に対応
   • 出力：位置情報、大陸continent、国country、所属機関owner、通信事業者isp、郵便番号zipcode、タイムゾーンtimezone、精度accuracy、国コードareacode、AS番号asnumber、緯度lat、経度lng、省prov、市city、区・県district、街区レベルの住所address

1. IP位置特定製品には3段階の位置特定精度があります。環境変数で設定します（下記の環境変数設定を参照）。
2. 都市レベル：最大の位置特定精度は都市 city です。
3. 区・県レベル：最大の位置特定精度は区・県 district です。
4. 街区レベル：最大の位置特定精度は街区 address です。

2. 現在のネットワークIPアドレスと位置情報を取得 user_network_ip

   • 説明：現在のネットワークIPアドレスとIP位置情報を取得します（都市、区・県、街区の3段階の精度に対応）。IPv4とIPv6に対応しています。
   • パラメーター なし
   • 出力結果 上記と同じ

3. IP利用シーン ip_usage_scene

   • 説明：IP利用シーン。IPアドレスからIPの利用シーンを取得します。出力には、予約済みIP、未割り当てIP、組織・機関、モバイルネットワーク、家庭用ブロードバンド、データセンター、企業専用線、CDN、衛星通信、インターネットエクスチェンジ、Anycastなどのネットワーク利用シーンが含まれます。
   • パラメーター： ip：IPアドレス。IPv4、IPv6に対応
   • 出力：利用シーン scene

4. IP Whois ip_whois_info

   • 説明：Whois情報。IPアドレスからWhois登録情報を照会し、IPが属するネットワーク範囲、所属機関名、技術担当者、管理者などの情報を取得します。
   • パラメーター： ip：IPアドレス。IPv4に対応
   • 出力：Whois登録情報、netname、status、owner、techinfo、admininfoなど

5. AS Whois ip_as_mapping

   • 説明：IPアドレスのAS番号（自律システム番号）情報を照会します。
   • パラメーター： ip：IPアドレス。IPv4に対応
   • 出力：AS関連情報、asname、asn、allocated、type、industryなど

6. IPホスト情報 ip_host_info

   • 説明：IPホスト情報。IPアドレスから、自律システム番号（AS Number）、AS名、通信事業者、所属機関などの帰属属性を照会します。
   • パラメーター： ip：IPアドレス。IPv4に対応
   • 出力：AS関連情報、asname、asnumber、isp、ownerなど

7. IPリスクプロファイル ip_risk_portrait

   • 説明：IPリスクプロファイル。IPアドレスからIPリスクプロファイルを取得します。VPN、プロキシ、秒ダイヤル、データセンター、Torノード、ポートスキャン、ブルートフォース攻撃などの高リスク行為を識別し、リスクスコア、リスクレベル、IP位置などの情報を出力します。
   • パラメーター：ip：IPアドレス。IPv4に対応
   • 出力：リスクタグtag、リスクレベルlevel、リスクスコアscore、位置・シーン情報continent、country、prov、city、sceneなど

8. IP実ユーザー判定 ip_identity_check

   • 説明：IP実ユーザー判定。IPアドレスから、アクセス元が実ユーザーか機械トラフィックかを判定します。実ユーザーの確率（real_person_rate）、秒ダイヤルの確率（mb_rate）を返します。
   • パラメーター：ip：IPアドレス。IPv4に対応
   • 出力：実ユーザーの確率real_person_rate、秒ダイヤルの確率mb_rate、自律システム番号asnumber、通信事業者isp

9. IPv4業種 ip_industry_classify

   • 説明：IPv4業種。IPアドレスの業種分類を照会します。
   • パラメーター：ip：IPアドレス。IPv4に対応
   • 出力：IPv4の所属業種industry

インターフェースの詳細な返却データについては、公式APIドキュメントを参照してください。

クイックスタート

API KEYの取得

埃文科技の公式サイトからKEYを取得

環境変数の設定

環境変数の説明：

1. AIWEN_API_KEY 製品のAPI KEY
2. IPV4_ACCURACY（デフォルト値：city）IPv4の位置特定精度を設定します。購入したAPIのバージョンに応じて値を選択してください。
   選択可能な値：city（都市レベル）、district（区レベル）、street（街区レベル）
3. IPV6_ACCURACY（デフォルト値：city）IPv6の位置特定精度を設定します。購入したAPIのバージョンに応じて値を選択してください。
   選択可能な値：city（都市レベル）、district（区レベル）、street（街区レベル）

MCP HOSTでの設定と使用

cursor

{
    "mcpServers": {
        "aiwen-iplocation": {
            "command": "npx",
            "args": [
                "-y",
                "aiwen-mcp-server-geoip"
            ],
            "env": {
                "AIWEN_API_KEY": "xxxxxx",
                "IPV4_ACCURACY": "city",
                "IPV6_ACCURACY": "city",
            }
        }
    }
}

vscode

{
    "mcpServers": {
        "aiwen-iplocation": {
            "command": "npx",
            "args": [
                "-y",
                "aiwen-mcp-server-geoip"
            ],
            "env": {
                "AIWEN_API_KEY": "xxxxxx",
                "IPV4_ACCURACY": "city",
                "IPV6_ACCURACY": "city",
            }
        }
    }
}

利用シーン

• IPアドレスの地理的位置をすばやく照会する必要があるアプリケーション
• ネットワークセキュリティとアクセス制御、IPの送信元の検証
• IPの地理的位置に関連するデータ分析、科学研究
• IPシーンデータを取得するアプリケーション
• IP Whois情報を取得するアプリケーション
• IP AS情報を取得するアプリケーション
• IPホスト情報を取得するアプリケーション
• IPリスクプロファイルを取得するアプリケーション
• IP実ユーザー情報を取得するアプリケーション
• IP業種情報を取得するアプリケーション