VPNDetection

VPNDetection MCP サーバー

VPNDetection API の公式 Model Context Protocol サーバーです。

AI エージェントに、匿名性を検出するための読み取り専用ツールを7つ提供します。アドレスが VPN、住宅用、データセンター用、モバイル用またはパブリックプロキシ、Tor ノード、プライバシーリレーまたはウェブゲートウェイ、ホスティングプロバイダーまたは CDN に属しているかどうかを調べるほか、データベースカタログや、それぞれに対する組織のライセンス状況も確認できます。

はじめに

https://mcp.vpndetection.io/mcp でホストしており、VPNDetection アカウントでサインインして利用できます。npm を使ってお使いのマシンで実行することもできます。

Claude で使う

claude.ai、デスクトップアプリまたは Cowork で、https://mcp.vpndetection.io/mcp をカスタムコネクターとして追加し、プロンプトが表示されたら Claude の公開済み ID を使用 を選択します。Claude Code では、スキルとともにサーバーを追加するプラグインをインストールします。

/plugin marketplace add vpndetection-io/claude-plugin
/plugin install vpndetection@vpndetection

どちらの場合も VPNDetection アカウントでサインインし、Claude に API キーが知られることはありません。手順、スキル、接続の解除方法については、docs.vpndetection.io/integrations/claude をご覧ください。

ChatGPT と Codex で使う

ウェブ版 ChatGPT で、Plugins の下に https://mcp.vpndetection.io/mcp をカスタム MCP サーバーとして追加し、OAuth を選択します。Codex では、スキルとともにサーバーを追加するプラグインをインストールします。

codex plugin marketplace add vpndetection-io/openai-plugin
codex plugin add vpndetection@vpndetection
codex mcp login vpndetection

どちらの場合も VPNDetection アカウントでサインインし、API キーが知られることはありません。手順については、docs.vpndetection.io/integrations/chatgpt と docs.vpndetection.io/integrations/codex をご覧ください。OpenAI API では、Responses API の mcp ツールにサーバーを server_url として、キーを authorization として指定します。

その他の MCP クライアントで使う

https://mcp.vpndetection.io/mcp を指定します。MCP 認証に対応するクライアントなら、同じ方法でサインインできます。対応していない場合は、Authorization: Bearer your-key としてキーを送信できます。

お使いのマシンで実行する

開始時に API キーは必要ありません。 キーがなくても、1日あたり最大1000回、送信元アドレスごとに ip と is_vpn を取得できます。無料のキーを使うと、Tor とリレーの検出、アドレスの所在地、アドレスをアナウンスする AS が利用できます。有料プランでは、すべてのフィールドを取得できます。

以下を MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "vpndetection": {
      "command": "npx",
      "args": ["-y", "vpndetection-mcp"]
    }
  }
}

Node.js 22 以降が必要です。

キーを使うと、プロバイダー名、分類データベース、プロキシファミリーを利用できます。環境に設定してください。

{
  "mcpServers": {
    "vpndetection": {
      "command": "npx",
      "args": ["-y", "vpndetection-mcp"],
      "env": { "VPNDETECTION_API_KEY": "your-key" }
    }
  }
}

別のエンドポイントを指定する必要がある場合は、VPNDETECTION_BASE_URL で上書きできます。

ツール

ツール	内容
lookup_ip	1つのアドレスを分類します。
lookup_ips	1回の呼び出しでアドレスのリスト全体を分類し、アドレスをキーとして結果を返します。長いリストは自動的に分割して処理します。
my_entitlement	このキーで利用できる内容と利用状況を返します。プラン、フィールドのティア、現在までのリクエスト数、利用枠、リセット日時が含まれます。
list_databases	公開しているすべてのデータベースと、組織におけるそれぞれのstanding（licensed、expired、unlicensed）を返します。
database_metadata	データベースの列、サンプル行、行数、ビルド日、ファイルサイズを返します。
database_checksum	1つのデータベースファイルについて、公開されているダイジェストを返します。
list_downloads	拒否されたものも含め、組織で最近行われたダウンロードの試行を返します。

データベースのツールにはdb.downloadスコープを持つキーが必要です。この組織のDefaultキーにはそのスコープがあります。

すべてのツールは読み取り専用です。ダウンロードツールは意図的に用意していません。データベースは数GBに及ぶため、エージェントが会話に取り込むべきものではありません。代わりに、クライアントライブラリまたはAPIを使って取得してください。

my_ipツールは意図的に用意していませんが、すべてのクライアントライブラリにはあります。 ホスト型トランスポートでは、エッジが認識するアドレスは呼び出しをプロキシしたもの（質問した本人ではなく、Claudeのインフラストラクチャ）に属します。そのため、このツールは誰もが唯一知りたい用途に対して、自信満々に誤った回答を返すことになります。my_entitlementにはこの問題はなく、接続ではなく認証情報についての情報なので、どのトランスポートでも同じ回答になります。誤って再追加されないよう、テストでこのツールが存在しないことを確認しています。

利用回数は暦月や請求期間ではなく、サブスクリプションの契約日を基準に計算されます。hard_limitがnullの場合、サービスの提供を停止しないことを意味します。上限がゼロという意味ではありません。

結果の読み方

各検索結果には、coverageブロックが付随します。

{
  "result": { "ip": "45.83.91.1", "is_vpn": true },
  "coverage": {
    "included": ["ip", "is_vpn"],
    "not_included": ["is_hosting", "is_tor", "hosting", "tor", "..."],
    "note": "The fields in not_included were not returned, because this API key's plan does not include them. ..."
  }
}

通常のクライアントライブラリよりも、ここではこの情報が重要です。結果にフィールドがない場合は、プランにそのフィールドが含まれていないことを意味し、「確認した結果、何も見つからなかった」という意味ではありません。結果を単独で読むモデルは、そうでなければフィールドがないことを否定的な回答として扱ってしまいます。coverageはその違いを明示し、誤解を防ぎます。

その他のライブラリ

PHP、Python、Go、Java、Rubyなど、多くの言語で利用できるVPNDetection公式クライアントライブラリがあります。Django、Rails、Laravelなどの人気フレームワーク向けのライブラリもあります。詳細については、https://github.com/vpndetection-io のGitHubをご覧ください。

VPNDetectionについて

VPN Detection API：VPN、住宅用プロキシ、ホスティングサーバー、Torノード、CDN、リレーなどを特定する、高精度な匿名性検出APIです。

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。