VPNDetection

VPNDetection MCP 服务

适用于 VPNDetection API 的官方 Model Context Protocol 服务。

它为 AI Agent 提供七种只读匿名性检测工具：检测地址是否属于 VPN、住宅代理、数据中心代理、移动代理或公共代理、Tor 节点、隐私中继或 Web 网关、托管服务提供商或 CDN；还可查询数据库目录，以及你所在组织对每项服务的许可状态。

开始使用

我们将其托管在 https://mcp.vpndetection.io/mcp，你可以使用 VPNDetection 账户登录。你也可以通过 npm 在自己的计算机上运行它。

在 Claude 中

在 claude.ai、桌面应用或 Cowork 中，将 https://mcp.vpndetection.io/mcp 添加为自定义连接器，并在出现提示时选择 使用 Claude 发布的身份。在 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 账户登录，ChatGPT 和 Codex 都不会看到你的 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 密钥。 不提供密钥时，每个来源地址每天最多可查询 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	分类单个地址。
lookup_ips	在一次调用中按地址分类整个地址列表。长列表会自动分批处理。
my_entitlement	此密钥享有哪些权益，以及已使用的额度：套餐、字段等级、当前请求数、额度，以及重置时间。
list_databases	我们发布的所有数据库，以及它们对贵组织的 standing：licensed、expired 或 unlicensed。
database_metadata	数据库的列、示例行、行数、构建日期和文件大小。
database_checksum	某个数据库文件已发布的摘要。
list_downloads	贵组织近期的下载尝试，包括被拒绝的尝试。

数据库工具需要具有 db.download 作用域的密钥，贵组织的 Default 密钥已具备该作用域。

所有工具均为只读。我们特意不提供下载工具：这些数据库有数 GB 大，不适合由 Agent 拉入对话中。请改用客户端库或 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 会明确说明两者的区别，避免产生这种误解。

其他库

我们为多种语言提供官方 VPNDetection 客户端库，包括 PHP、Python、Go、Java、Ruby；也支持 Django、Rails 和 Laravel 等许多热门框架。更多信息请访问我们的 GitHub：https://github.com/vpndetection-io

关于 VPNDetection

VPN Detection API：精准识别匿名流量，包括 VPN、住宅代理、托管服务器、Tor 节点、CDN、中继等。

许可证

本项目采用 MIT License 许可。