lazaretto

lazaretto-mcp

安装软件包之前，先了解它的作用。

一个用于 Lazaretto 的 MCP 服务：为 npm 软件包、AI Agent 技能和 MCP 工具提供确定性的安装前验证。免费锁文件检查会将每个精确固定版本的依赖项与 OSV 和 OpenSSF 恶意软件包公告进行匹配，无需账户。付费扫描会额外提供行为分析及文件和行号证据。

此软件包是 Lazaretto API 的轻量前端。它不包含检测逻辑，只会发出 HTTPS 请求，因此易于审计。

一行命令即可试用，无需安装任何内容

检查项目中每个精确固定版本的依赖项，并与已发布的恶意软件包公告进行比对。无需账户、密钥或安装：

curl -s https://lazaretto.dev/check --data-binary @package-lock.json

支持 package-lock.json、npm-shrinkwrap.json、yarn.lock 或 pnpm-lock.yaml。我们不会保留锁文件副本。

工具

check_lockfile（免费，无需 API 密钥）

检查锁文件中每个精确固定版本的依赖项，并与已发布的恶意软件包公告进行比对。从工作目录读取 package-lock.json、yarn.lock 或 pnpm-lock.yaml，因此 Agent 无需将锁文件粘贴到上下文中。一次调用即可覆盖整个依赖树。

只有在 unverified 也为空时，malicious 列表为空才表示一切正常。

• known_bad_lookup：免费，无需密钥。某个 SHA-256 内容哈希是否为已知恶意制品？与每日刷新的指标库进行精确哈希匹配。
• find_attestation：免费，无需密钥。是否有人已为此制品出具证明？提供类似 [email protected] 的软件包标识、MCP 服务 URL 或 SHA-256 内容哈希，即可获取已签名的判定（如果存在），以及其生成时间、是否基于旧版规则生成，以及在该对象目前已知为恶意时显示的 contradicted。未找到表示没有此对象的证明记录，并不代表判定结果是好是坏。
• verify_attestation：免费，无需密钥。扫描判定附带一份已签名的证明（紧凑型 JWS）。将其他 Agent、README 或锁文件提供的证明交给此工具：它会确认签名来自 Lazaretto，返回经证明的声明，并在某个曾被判为 clear 的对象目前已知为恶意时标记 contradicted，这样无需重新扫描或再次付费即可信任判定结果。仍需确认你将运行的制品与 claims.sub 相符。
• scan_artifact：获取目标（npm 或 PyPI 软件包、GitHub 仓库、ClawHub 技能、原始 URL 或内联文本），但不会运行它；随后返回确定性判定（malicious、flagged、clear、error）及证据。完整扫描需要预付额度：托管服务使用 X-API-Key 标头，stdio 软件包使用 LAZARETTO_API_KEY。请访问 https://lazaretto.dev/buy 购买。
• scan_lockfile_deep：付费，每个返回判定的软件包消耗 1 个额度。与 check_lockfile 相对应的行为分析工具：它会读取每个精确锁定版本的依赖项代码，每次最多处理 25 个，而不是只匹配名称和版本。请信任 complete_coverage：false 表示有内容达到上限、读取出错或仅部分读取，因此本次运行不能证明整个依赖树安全。使用相同锁文件再次调用会重新扫描相同的首批软件包，并再次计费。结果会在 not_scanned.packages 中列出所有未扫描的软件包，以 name@version 字符串表示。若要继续扫描，请将这些字符串作为 packages 传入，而不是传入锁文件：
  • 托管服务（https://lazaretto.dev/mcp）：将完整的 not_scanned.packages 列表作为 packages 传回。它会扫描前 25 个，并再次将其余项列入 not_scanned.packages。
  • stdio 软件包：每次调用的 packages 最多接受 25 个，因此请每次处理 not_scanned.packages 中的 25 个。工具会在结果中添加 next_call，其中 next_call.packages 保存该列表中的前 25 个。
• check_mcp_tools：付费。对于通过 stdio 运行的服务（大多数服务都是如此），外部无法连接，因此没有可供检查的端点。不过，你的客户端已在启动时读取了它的工具列表：粘贴该 JSON，我们就会按相同规则分析相同文本，完全不会联系任何服务。
• scan_mcp_server：付费。在连接 MCP 端点之前，先将其交给此工具。工具会要求服务介绍自身并列出其工具，然后分析服务传递给 Agent 的文本：工具名称、描述、参数架构及其指令。这些文本属于模型会遵循的文档，因此是由服务控制的指令通道。它可以检测工具投毒（例如要求读取 ~/.ssh/id_rsa 或 Agent 配置文件的隐藏指令）、用途是传出机密或对话内容的参数，以及针对其他服务工具的常驻命令。证据会指出具体工具。它只调用 initialize 和 tools/list，绝不会调用服务自身的工具。

报告是带有证据的信号，并非质量保证。clear 表示没有已知恶意匹配，也没有触发任何规则，但这并不代表风险为零。

使用它（托管，无需安装）

该服务托管于 https://lazaretto.dev/mcp。将其添加到任何支持远程（Streamable HTTP）服务的 MCP 客户端即可。无需安装，也无需本地进程。

{
  "mcpServers": {
    "lazaretto": {
      "url": "https://lazaretto.dev/mcp",
      "headers": {
        "X-API-Key": "your-prepaid-key (optional; the free tools need no key)"
      }
    }
  }
}

check_lockfile、known_bad_lookup、find_attestation 和 verify_attestation 无需密钥即可使用。scan_artifact、scan_lockfile_deep、 scan_mcp_server 和 check_mcp_tools 需要积分：请前往 https://lazaretto.dev/buy 购买积分包（拥有钱包的 Agent 也可以通过 x402 自行购买积分，使用 POST https://lazaretto.dev/v1/credits/topup）。

自托管 stdio 服务（可选）

如果你更愿意通过 stdio 在本地运行，而不是使用托管 URL，npm 包名为 lazaretto-mcp：

{
  "mcpServers": {
    "lazaretto": {
      "command": "npx",
      "args": ["-y", "lazaretto-mcp"],
      "env": {
        "LAZARETTO_API_KEY": "your-prepaid-key (optional; the free tools need no key)"
      }
    }
  }
}

或者从克隆的仓库运行：

git clone https://github.com/jamesdfinance-dev/lazaretto-mcp
cd lazaretto-mcp && npm ci
read -rs LAZARETTO_API_KEY && export LAZARETTO_API_KEY
node index.mjs

stdio 包仅使用 LAZARETTO_API_KEY 中的预付积分进行支付。它本身没有 x402 客户端，因此付费墙响应不包含 x402 支付质询：每次调用的 x402 支付必须由 Agent 使用自己的 HTTP 客户端直接向 https://lazaretto.dev/v1/scan 发起，而不能通过此包完成。 LAZARETTO_BASE_URL 可覆盖 API 主机（默认为 https://lazaretto.dev）。

许可证

MIT。Lazaretto 服务及其检测引擎为独立的专有产品。