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 工具标识符,因此应将这些能力领域视为接口契约,而非你的客户端所呈现的某个具体工具名称。
问题所在:你的模型的浏览器支持数据有”保质期”
Discover how at OpenReplay.com.
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 |
| 智能体 CLI | Claude 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 数据,说明连接运行正常。