12k
All articles

MDN 现已成为 MCP 服务器

MDN 的 MCP 服务器让 AI 编码代理直接获取搜索、文档和浏览器兼容性数据,并介绍安装步骤与隐私注意事项。

OpenReplay Team
OpenReplay Team
MDN 现已成为 MCP 服务器

MDN MCP 服务器是 Mozilla 官方推出的实验性 Model Context Protocol 服务器,它为 AI 编程智能体和 IDE 提供直接访问 MDN 搜索、文档及浏览器兼容性数据的能力。

如果你曾遇到 AI 助手断然告知你某个 Web 特性不支持 Firefox,而实际上该特性早在几个版本前就已发布的情况,这正是该服务器所要解决的痛点。该服务器于 2026 年 6 月中旬上线,托管地址为 https://mcp.mdn.mozilla.net/,开源代码位于 github.com/mdn/mcp。由于它发布时几乎未出现在任何模型的训练数据中,未被明确指向该服务器的 AI 助手甚至不知道它的存在。

本文将介绍该服务器的实际功能、它所针对的训练截止日期问题、一键式配置方法及支持的客户端、Mozilla 自身的前后对比测试结果,以及需要坦诚说明的注意事项:它是一项实验性功能,会存储查询数据,且可能随时下线。

核心要点

  • MDN MCP 服务器是 Mozilla 官方的第一方 MCP 服务器,地址为 https://mcp.mdn.mozilla.net/(源码位于 github.com/mdn/mcp,采用 MPL-2.0 协议)。它并非早于其发布的第三方”MDN Lookup”社区服务器之一。
  • 它通过 Model Context Protocol 向你的 AI 智能体开放三个能力领域:MDN 搜索、文档查询和浏览器兼容性数据。
  • 只需一条命令即可完成添加:claude mcp add --transport http mdn https://mcp.mdn.mozilla.net/,任何 MCP 客户端均可指向同一远程 HTTP 端点。
  • 在 Mozilla 于 2026 年 6 月针对 Firefox 151 的四项特性使用 Claude Opus 4.7 进行的测试中,接入 MCP 的模型能够准确输出浏览器支持数据,而未接入 MCP 的模型在四个测试用例中仅有一个结果正确,且接入 MCP 后的响应速度约快两倍。
  • 该服务器明确定位为实验性项目:Mozilla 在实验期间会存储查询数据,提供退出选项的请求头,且可能随时下线。

MDN MCP 服务器是什么(以及它不是什么)?

MDN MCP 服务器是 Mozilla 官方的第一方 Model Context Protocol 服务器,它通过 MCP(连接 AI 工具与外部数据源的开放标准)向你的 AI 智能体开放三个能力领域:MDN 的搜索、文档和浏览器兼容性数据。其 GitHub 仓库将其标注为”原型”,并采用 MPL-2.0 协议授权。

有必要做一个概念区分。搜索”MDN MCP”时,你会看到一些名为”MDN Lookup”的非官方社区封装项目,它们早于本次发布。那些都是第三方项目。本文所介绍的服务器是 Mozilla 自己的官方服务器,托管于 mozilla.net 域名下,并在 MDN 组织的 mdn/mcp 仓库中维护。在本文中,“MDN MCP 服务器”特指该第一方服务器,而非任何社区重新实现的版本。

该服务器开放了上述三个能力领域,但未发布稳定的 MCP 工具标识符,因此应将这些能力领域视为接口契约,而非你的客户端所呈现的某个具体工具名称。

问题所在:你的模型的浏览器支持数据有”保质期”

AI 编程工具存在训练截止日期,因此可能输出过时的 Web 平台信息。模型可能不知道某个较新特性的存在,或者错误判断该特性是否已达到某个 Baseline 状态、是否可以安全地跨浏览器使用。Mozilla 自己举的例子是 CSS at 规则 @view-transition:模型可能不知道它的存在,也不知道它是否已”广泛可用”(Widely Available)。

浏览器支持情况正是那种随时间快速过时的信息。一个在模型训练时还处于实验性标志(flag)后面的特性,可能在数周后就正式发布到稳定版,而模型对此一无所知。向智能体实时提供来自 MDN 的兼容性数据,可以弥补这一差距,而无需你离开编辑器去手动查阅兼容性表格。

如何添加 MDN MCP 服务器?

只需一条命令即可完成添加。对于 Claude Code,Mozilla 在发布公告和 /mcp 参考页面上均记录了如下确切调用方式:

claude mcp add --transport http mdn https://mcp.mdn.mozilla.net/

这会注册一个名为 mdn 的远程 HTTP MCP 服务器,指向 Mozilla 托管的端点。其他所有兼容 MCP 的客户端遵循相同模式:通过该客户端自身的 MCP 配置,添加指向 https://mcp.mdn.mozilla.net/ 的远程 HTTP MCP 服务器。Mozilla 列出的支持客户端如下:

类别客户端
编辑器VS Code、Zed、Cursor
智能体 CLIClaude Code、Codex CLI、Antigravity CLI(前身为 Gemini CLI
聊天应用Claude Desktop

对于 VS Code、Zed 和 Cursor,除了在客户端的 MCP 设置中注册同一个远程 HTTP 端点外,无需任何特殊的 JSON 配置。要确认连接是否正常,可以向你的智能体提问一个关于近期发布特性的浏览器支持问题,检查它是否以最新的 MDN 数据作答,而非含糊其辞。

Mozilla 自身测试的发现

Mozilla 进行了自己的前后对比测试,因此以下数据是其自身的测量结果,并非独立验证:它让 Claude Opus 4.7 针对 Firefox 151 的四项特性(Mozilla 测试时使用的版本;当前稳定版为 153),分别在有无 MCP 的情况下,询问每项特性的使用方法及浏览器支持情况。

两种情况下的使用说明大体相当。但浏览器支持数据则大相径庭。在没有 MCP 的情况下,模型在四个测试用例中仅有一个结果正确:

特性(Firefox 151)无 MCP有 MCP
图像的 light-dark()无具体支持数据完整表格(Firefox 150,Chrome 在实验性标志后)
:buffering 伪类正确正确
<template> 上的 shadowrootslotassignment错误:声称 Chrome 120 / Safari 18.3正确:Firefox 151 率先发布
Web Serial API错误:声称 Firefox 未实现正确:Firefox 151 已发布

有两个结果尤为突出。模型将声明式 shadowrootslotassignment 属性与命令式 slotAssignment 选项混淆,并断然否认 Firefox 支持 Web Serial API。Mozilla 还报告称,使用 MCP 的响应速度约快两倍,因为模型查询的是结构化数据,而非抓取并解析 MDN 的 HTML 页面。

注意事项:这是一项实验

在决定使用之前,请认真阅读其实验性定位说明。Mozilla 明确指出,MDN MCP 服务器作为实验项目运行,会在实验期间存储所接收查询的数据,且可能随时下线。这些查询数据不与个人身份信息绑定,但 Mozilla 警告称,你向大语言模型透露的任何私密信息都可能出现在这些查询中,并直接建议:如果这是一个顾虑,请勿使用该服务器。

有两种规避方式。若要将查询排除在第一方分析之外,可在向 MCP 发送请求时附带 X-Moz-1st-Party-Data-Opt-Out: 1 请求头。或者自行运行服务器:执行 npm install,然后 npm start,并将你的客户端指向本地端点:

claude mcp add --transport http mdn-local http://localhost:3002/

自托管可将每条查询保留在你自己的机器上,这是处理隐私敏感工作的最彻底方案。

结语

如果你的 AI 助手经常误报浏览器支持情况,且你能接受一个 Mozilla 可能随时下线的实验性依赖,那么请添加 MDN MCP 服务器;如果查询隐私至关重要,则选择自托管。这是一个小小的、一条命令即可完成的改动,它将对兼容性数据的猜测替换为 MDN 的实时表格,并针对所有存在训练截止日期的模型所共有的缺陷。将其接入你的编辑器或智能体,询问一个本月刚发布的特性,然后对照当前的 MDN 页面核查答案。

常见问题

为什么不直接让 AI 智能体读取 MDN 页面,而要使用 MCP 服务器?

MCP 服务器返回结构化的搜索、文档和兼容性数据,而直接读取页面会迫使智能体抓取并解析 MDN 的完整 HTML 页面。在 Mozilla 自己的测试中,直接抓取的方式不仅更慢,仍然会产生错误的浏览器支持答案;而 MCP 响应速度约快两倍,因为模型查询的是结构化数据,而非解析页面标记。MCP 接口是专为兼容性查询而设计的,因此返回的是清晰的表格,而非冗余的页面内容。

MDN MCP 服务器是否免费使用?

是的。Mozilla 将 MDN MCP 服务器托管于 'https://mcp.mdn.mozilla.net/',未列出任何费用,且源码以 MPL-2.0 协议在 github.com/mdn/mcp 开放。你也可以通过 'npm install' 和 'npm start' 免费自托管,将客户端指向 'http://localhost:3002/'。请注意,该服务器明确定位为实验性项目,可能随时下线,因此免费访问并非永久性保证。

MDN MCP 服务器是否会存储我的查询?我能阻止它吗?

Mozilla 在服务器作为实验项目运行期间会存储所接收查询的数据,这些数据不与个人身份信息绑定,但你向大语言模型输入的任何私密内容都可能出现在这些查询中。若要将查询排除在第一方分析之外,请在请求中附带 'X-Moz-1st-Party-Data-Opt-Out: 1' 请求头。若要完全隔离,请在本地运行服务器,这样每条查询都保留在你自己的机器上,永远不会到达 Mozilla。

如何确认我的 AI 智能体是否真正在使用 MDN MCP 服务器?

向它提问一个近期发布特性的浏览器支持问题,然后检查答案是否反映了当前的 MDN 兼容性数据,而非含糊其辞或给出过时的猜测。未接入 MCP 的模型通常会否认较新特性的存在,或误报哪些浏览器版本支持该特性,正如 Mozilla 在 Web Serial API 和 shadowrootslotassignment 测试中所观察到的那样。能够给出准确的、包含具体版本号的兼容性答案并引用当前 MDN 数据,说明连接运行正常。

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — self-hosted, with full data ownership.

Star on GitHub

We use cookies to improve your experience. By using our site, you accept cookies.