Maskbreak

Name: Maskbreak
Author: maskbreak.com

本地服务

maskbreak.com安全22 周前更新

代码仓库访问官网

关于 Maskbreak

Maskbreak MCP 服务让 Claude、Cursor 等客户端查询有限范围的公开 IP 情报，包括云托管网段和 Tor 出口节点，并查看 API 状态。它提供本地 stdio 服务和远程 HTTP 端点，结果不涵盖 VPN、代理或设备证据。

主要功能

01查询公开 IPv4 和 IPv6 信号
02识别云托管与 Tor 出口
03返回风险评分和处置建议
04查看 API 健康度、可用率与延迟
05支持本地及远程连接

适用场景

01在欺诈检查中查看 IP 信号
02核查 IP 是否属于 Tor 出口节点
03检查 Maskbreak API 状态

MCP 相关

向 MCP 客户端提供 `lookup_ip` 和 `service_status` 工具。本地服务使用 stdio，远程端点 `https://maskbreak.com/mcp` 使用 Streamable HTTP。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-maskbreak": {
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>",
        "SENTINEL_BASE_URL": "<SENTINEL_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @sentinelsup/mcp

需要配置的环境变量

MASKBREAK_API_KEY密钥Maskbreak API key for your plan's lookup allowance (100,000 a month on the Free plan). Without it, lookups use the rate-limited keyless endpoint. The older SENTINEL_API_KEY name is still read.

SENTINEL_BASE_URLAPI base URL override, for testing.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@sentinelsup/mcp0.1.8stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
ip	string	是	要检查的公共 IPv4 或 IPv6 地址，例如 "185.220.101.34"

详细介绍

Maskbreak MCP 服务

从 Claude、Cursor 或其他 MCP 客户端查询有限的公开 IP 情报——云托管网段和 Tor 出口节点。由 Maskbreak 欺诈检测 API 提供支持。本地服务需要 Node.js 18+。

工具

工具	功能
`lookup_ip`	查询公开 IPv4/IPv6：`known`、`allow` / `review` / `block`、风险评分，以及可为空的信号/网络元数据。公开数据源仅覆盖云托管和 Tor。
`service_status`	Maskbreak API 的健康状态、运行时间和延迟

设置

在 maskbreak.com/signup 获取免费 API 密钥（Free 计划每月包含 100,000 次 IP 查询，无需信用卡；付费计划每月 €29 起，可提高限额）。无密钥模式使用免费的 Web 工具端点，每个调用方 IP 限制为每分钟 12 次、每天 80 次查询。还可能适用其他端点和滥用防护限制。

两种模式都不会访问浏览器。VPN/代理和设备证据需要在这些工具之外，通过基于浏览器 SDK 的 /v1/evaluate 请求获取；仅当服务名称已知时才会提供。未知 IP、错误信号和 allow 判定都不能证明安全。

Claude Code

claude mcp add sentinel -e MASKBREAK_API_KEY=sk_live_your_key -- npx -y @sentinelsup/mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "sentinel": {
      "command": "npx",
      "args": ["-y", "@sentinelsup/mcp"],
      "env": { "MASKBREAK_API_KEY": "sk_live_your_key" }
    }
  }
}

Cursor / 其他 MCP 客户端

任何支持 stdio MCP 的客户端都可以使用相同方式：命令为 npx，参数为 ["-y", "@sentinelsup/mcp"]，环境变量为 MASKBREAK_API_KEY。

托管端点（无需安装）

更倾向于使用远程服务？相同的工具托管在 https://maskbreak.com/mcp（Streamable HTTP）。将任意基于 URL 的 MCP 客户端指向该端点；传入 API 密钥作为 Authorization: Bearer 标头，即可获得完整配额。

示例

“此 IP 有哪些公开数据源证据？”

以下为未知 IP 的示例响应，并非实时查询结果：

{
  "ip": "192.0.2.1",
  "known": false,
  "verdict": "allow",
  "risk_score": 0,
  "signals": null,
  "network": null
}

环境变量

变量	必需	默认值	用途
`MASKBREAK_API_KEY`	建议设置	—	来自你的控制面板的 API 密钥；可解锁你计划的查询额度（Free 计划每月 100,000 次）。自 v0.1.5 起提供；仍会读取旧名称 `SENTINEL_API_KEY`
`SENTINEL_BASE_URL`	否	`https://maskbreak.com`	用于测试的覆盖值

故障与本地检查

对于 HTTP 故障、格式错误的响应，或超过五秒超时的请求（包括读取响应正文），两个工具都会返回 MCP isError: true。查询不可用不代表允许访问。

npm ci --ignore-scripts
npm test
npm pack --dry-run --ignore-scripts
npm audit

测试使用真实的 stdio MCP 客户端和环回 HTTP 测试夹具，无需生产密钥。CI 会检查 Node.js 18、22 和 24。不会通过这些检查发布任何软件包。

链接

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。