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