Mozilla Observatory

@pipeworx/mozilla-observatory

MDN HTTP Observatory——使用 Mozilla 的公开扫描器评估任意网站的 HTTP 安全标头，并获取具体修复建议。

属于 Pipeworx——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• observatory_scan(host) — 执行扫描（或返回 Mozilla 最近一次扫描的结果），并提供 A+..F 字母等级、数值分数以及通过／未通过的数量。
• observatory_results(host, only_failures?, include_history?, history_limit?) — 返回全部 12 项测试的通过／未通过状态、分数影响、Mozilla 提供的修复说明、检测到的响应标头，以及该主机的等级历史记录。
• observatory_grade_distribution() — 显示每个等级对应的已扫描网站数量，以便将单个等级与整个网络的总体情况进行比较。

身份验证

无需密钥。

数据源

• POST https://observatory-api.mdn.mozilla.net/api/v2/scan?host= — 扫描摘要。
• GET https://observatory-api.mdn.mozilla.net/api/v2/analyze?host= — 完整详情。
• GET https://observatory-api.mdn.mozilla.net/api/v2/grade_distribution — 直方图。

否则接手的人可能会重新发现的问题

• 详情端点是 /analyze，不是 /scan。 GET /api/v2/scan?host= 会返回 404——/scan 仅支持 POST。/api/v2/tests?scan=<id> 和 /api/v2/scan/<id> 也都会返回 404（均已于 2026-09-17 验证）。直方图端点是 grade_distribution，中间有下划线；使用连字符的拼法会返回 404。
• tests_failed 和 pass: false 的结果不一致，但两者都没错。 Mozilla 只将会降低分数的失败计入 tests_failed，但对于 score_modifier 为 0 的信息性测试，也会设置 pass: false——2026-09-17，mozilla.org 报告的 tests_failed: 2，但有四项测试被标记为未通过。该包会为每项测试返回 penalized 标记和 tests_failing_with_score_impact 计数，而不会删去 零影响的行，因此 only_failures 返回的行数多于 tests_failed 属正常情况， 且响应负载中对此有说明。
• recommendation 和 score_description 是 HTML 片段。 返回前会将其转换为纯文本。
• 无法解析的主机会返回状态码为 200、且 error 字段有值的响应，而非 HTTP 错误；该包会针对这种情况抛出异常。

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "mozilla-observatory": {
      "url": "https://gateway.pipeworx.io/mozilla-observatory/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/mozilla-observatory/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 共享的元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及其他网关级工具。因此你看到的工具数量会多于此表中的数量：目前，单个工具包端点除了该工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其准确范围，是当天情况的权威依据。

这是有意为之，并非意外的多路复用。这些元工具可以让限定范围的连接通过 ask_pipeworx 跨整个目录路由，从而回答此工具包无法处理的问题，而无需你添加第二个 MCP 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文比路由功能带来的价值还多，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一网关和相同的 1683+ 个数据源。唯一的区别是，哪个工具包的工具会被直接列出；无论通过哪个 URL，ask_pipeworx 都能访问所有工具包。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/observatory_scan \
  -H 'Content-Type: application/json' \
  -d '{"host":"mozilla.org"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/observatory_scan。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "mozilla-observatory": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-mozilla-observatory"]
    }
  }
}

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-mozilla-observatory

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Mozilla Observatory data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT