VPNDetection

io.github.vpndetection-iov5.3.6更新於 Oct 3, 2026

VPN, proxy, Tor, hosting and CDN detection for any IP address, from the VPNDetection API.

已驗證Streamable HTTP可網頁執行Web Search & ScrapingSecurity & Monitoring

概覽

AI 產生的概覽

讓助理把 IP 位址判定為 VPN、代理、Tor、主機代管或 CDN，並查看服務商的偵測資料庫與授權狀態。

功能
把 VPNDetection API 包裝成七個唯讀工具。lookup_ip 判定單一位址，lookup_ips 一次批次判定一整組位址。my_entitlement 回報方案、欄位層級、已用請求數、額度與重設時間；list_databases、database_metadata、database_checksum 和 list_downloads 涵蓋已發布的資料庫以及貴組織的下載嘗試。結果附帶 coverage 區塊，說明方案未回傳哪些欄位。
適用情境
適合助理需要判斷某個 IP 是否為匿名流量，用於詐欺、濫用或存取檢查，或查看貴組織已獲授權使用哪些偵測資料庫。它為唯讀，因此適合查詢與報告，而不是執行處置動作。
執行需求
可使用託管端點 mcp.vpndetection.io 並以 VPNDetection 帳號登入，也可在本地以 Node.js 22 或更新版本執行 npm 套件 vpndetection-mcp。免費層無需金鑰即可回答 ip 與 is_vpn，每個來源位址每天 1000 次請求；VPNDETECTION_API_KEY 可解鎖服務商名稱、分類資料庫與代理類型。VPNDETECTION_BASE_URL 可覆寫端點。
安裝前請注意
API 金鑰屬於憑證，應放在環境變數中而非共用設定檔裡。查詢會把所查位址傳送給第三方 VPNDetection，請避免提交你認為敏感的位址。用量依訂閱週年而非日曆月計算，hard_limit 為 null 表示不設上限而非零。結果中缺少的欄位表示方案不含該欄位，而不是查無任何情況。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 VPNDetection，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.vpndetection.io/mcp"
    }
  }
}

README

[VPNDetection] VPNDetection MCP Server

[npm] [license]

The official Model Context Protocol server for the VPNDetection API.

It gives an AI agent seven read-only tools for anonymity detection: whether an address belongs to a VPN, a residential, datacenter or mobile proxy, a Tor node, a public relay, a hosting provider or a CDN, plus the database catalog and where your organization's license for each one stands.

Getting Started

We host it at https://mcp.vpndetection.io/mcp, and you sign in to it with your VPNDetection account. It also runs on your own machine from npm.

In Claude

In claude.ai, the desktop app or Cowork, add https://mcp.vpndetection.io/mcp as a custom connector and choose Use Claude's published identity when asked. In Claude Code, install our plugin, which adds the server with skills:

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

Either way you sign in with your VPNDetection account, and Claude never sees your API key. The steps, the skills and how to disconnect: docs.vpndetection.io/integrations/claude.

In any other MCP client

Point it at https://mcp.vpndetection.io/mcp. A client that supports MCP authorization signs in the same way. One that doesn't can send a key instead, as Authorization: Bearer your-key.

On your own machine

No API key needed to start. The free tier answers ip and is_vpn, and allows 1000 requests per day per source address.

Add this to your MCP client's config:

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

Requires Node.js 22 or newer.

A key unlocks the provider name, the classification databases and the proxy families. Put it in the environment:

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

VPNDETECTION_BASE_URL overrides the endpoint if you need to point somewhere else.

Tools

ToolWhat it answers
lookup_ipClassify one address.
lookup_ipsClassify a whole list of addresses in one call, keyed by address. A long list is batched for you.
my_entitlementWhat this key is entitled to and what it has spent: plan, field tier, requests so far, allowance, and when it resets.
list_databasesEvery database we publish, with its standing for your organization: licensed, expired or unlicensed.
database_metadataA database's columns, sample rows, row count, build date and file sizes.
database_checksumThe published digests for one database file.
list_downloadsYour organization's recent download attempts, refusals included.

Every tool is read-only. There is deliberately no download tool: the databases run to several GB, which is not something an agent should pull into a conversation. Fetch them with the client libraries or the API instead.

There is deliberately no my_ip tool, although every client library has one. Over a hosted transport the address our edge observes belongs to whatever proxied the call - Claude's infrastructure, not the person asking - so the tool would answer confidently and wrongly for the only reading anyone would put on it. my_entitlement has no such problem and is the same answer from any transport, because it describes the credential rather than the connection. A test pins the tool's absence so it cannot be added back by accident.

Usage counts against the anniversary of the subscription, not the calendar month and not the billing period. A null hard_limit means we never stop serving; it is not a limit of zero.

Reading a result

Each lookup comes back with a coverage block beside it:

json
{  "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. ..."  }}

This matters more here than in a normal client library. A field missing from a result means your plan doesn't include it, never "we checked and found nothing" - and a model reading the result on its own will otherwise treat the absence as a negative answer. coverage states the difference explicitly so it can't.

Other Libraries

There are official VPNDetection client libraries available for many languages including PHP, Python, Go, Java, Ruby, and many popular frameworks such as Django, Rails, and Laravel. See our GitHub at https://github.com/vpndetection-io for more.

About VPNDetection

VPN Detection API: Accurate anonymity detection identifying VPNs, residential proxies, hosting servers, Tor nodes, CDNs, relays and more.

[VPNDetection]

License

This project is licensed under the MIT License.

來源：README.md，提交 7f270f4

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v5.3.6最新Oct 3, 2026