在 2024 年底,Anthropic 推出了 MCP (Model Context Protocol),试图为 AI 模型与外部数据源之间构建一条"通用数据总线"。然而,对于广大的前端开发者和 Web 生态来说,传统的 MCP 更多是在后端或桌面端发力。
2025 年初,由 Google 和 Microsoft 工程师联合发起的 WebMCP 提案正式进入 W3C Web 机器学习社区组(WebML CG)的视野。它标志着 AI 智能体(Agent)正式获得了与 Web 页面进行"结构化对话"的官方绿卡。

本文将为你深度拆解 WebMCP 的前世今生、核心机制以及它将如何重塑前端开发者的技能图谱。
一、 为什么我们需要 WebMCP?
在 WebMCP 出现之前,AI 智能体访问网页的方式极其原始。
1.1 "脆弱"的旧世界:屏幕抓取(Screen Scraping)
现在的 AI 智能体(如各种浏览器助手)通常通过解析 DOM 树、截图并发送给多模态模型来"理解"网页。
- 痛点:网页结构稍有变动(如 CSS 类名修改),智能体就会"迷路";
- 成本:频繁截图和发送长文本 DOM 导致 Token 消耗巨大,响应延迟高;
- 权限:智能体很难在复杂的认证环境下(如登录后的 Session)稳定工作。
1.2 MCP 的局限性
虽然 Anthropic 的 MCP 解决了数据接入的标准问题,但它主要是为 Server-to-Server 场景设计的。如果你想让 AI 访问你当前打开的购物页面并执行"加入购物车",在传统 MCP 下,你需要搭建一套后端代理逻辑,还要处理复杂的跨域和身份同步。
1.3 WebMCP:AI 的"浏览器原住民"方案
WebMCP 的核心思想是:让网页自己告诉浏览器和智能体它能做什么。
它将网页抽象为两个层:
- 人类层(Human Layer):传统的 HTML/CSS/JS,供人类视觉交互。
- 机器层(Machine Layer):由 WebMCP 定义的结构化工具契约,供 AI 直接调用。

二、 什么是 WebMCP?
WebMCP (Web Model Context Protocol) 是一个正在标准化的浏览器原生 API(目前已在 Chrome 146 Canary 版本中作为早期预览版提供)。
它允许开发者直接在前端代码中定义"工具(Tools)",这些工具可以:
- 被智能体发现:浏览器能通过特定的 API 告诉 AI:"这个页面可以查询库存、可以提交表单"。
- 被智能体调用:AI 不需要模拟点击,而是直接以 JSON 参数调用网页暴露的 JavaScript 函数。
- 共享上下文:由于工具运行在页面运行环境下,它们天然拥有当前的登录状态、Cookie 和内存状态。
三、 WebMCP 的核心架构与机制
WebMCP 引入了一个全新的全局对象:navigator.modelContext。
3.1 两个核心组件
- 宿主(Host)/ 智能体(Agent):通常是浏览器内置的 AI(如 Gemini Nano)或侧边栏助手。
- 页面(Web Page):充当"微型服务器",通过 WebMCP 接口提供工具、资源和提示词(Prompts)。
3.2 两种实现路径
为了让不同难度的项目都能接入,WebMCP 设计了两种 API 模式:
A. 声明式 API(Declarative API) ------ 低代码接入
如果你的页面已经有现成的 HTML 表单,你只需要添加几个属性,它就能变身 AI 工具。
HTML
<form toolname="search_flights" tooldescription="查询往返航班信息">
<input name="origin" type="text" placeholder="出发地" required>
<input name="destination" type="text" placeholder="目的地" required>
<button type="submit">搜索</button>
</form>
浏览器会自动解析这个表单,生成一个 AI 能够读懂的 JSON Schema。当 AI 需要查询航班时,它会向浏览器发送请求,浏览器代为填充表单并提交。
B. 命令式 API(Imperative API) ------ 深度集成
对于复杂的逻辑,你可以直接注册 JavaScript 函数:
JavaScript
// 注册一个查询天气工具
navigator.modelContext.registerTool(
'get_weather',
'获取指定位置的当前天气情况',
{
location: { type: 'string', description: '城市名' }
},
async (args) => {
const data = await fetchWeather(args.location);
return {
content: [{ type: 'text', text: `当前温度:${data.temp}度` }]
};
}
);

四、 动手实践:如何体验 WebMCP?
目前,WebMCP 处于快速演进阶段。想要尝鲜的开发者可以通过以下方式:
4.1 开启浏览器支持
- 下载 Chrome Canary (版本号 146+);
- 进入
chrome://flags; - 搜索并启用
#experimental-web-platform-features或#webmcp-test-api(具体名称随版本波动,建议查看 W3C 最新文档)。
4.2 使用现有的库
如果你不想等浏览器原生普及,可以使用 Jason McGhee 维护的 WebMCP 开源库。它通过一个轻量级的 WebSocket 桥接方案,让你现在就能在普通浏览器里体验"页面即 MCP Server"的效果。
代码示例(使用 WebMCP SDK):
JavaScript
import { WebMCP } from 'webmcp-sdk';
const mcp = new WebMCP();
// 暴露一个添加待办事项的方法给 AI
mcp.registerTool('add_todo', '在当前页面添加一条任务', {
text: { type: 'string' }
}, (args) => {
window.myTodoApp.addItem(args.text);
return "已成功添加任务";
});
五、 WebMCP 的核心价值:为什么开发者要关注?
对于内卷严重的 AI 赛道,WebMCP 提供了几个降本增效的杀手锏:
5.1 隐私与安全(端侧处理)
国内政企客户对数据出域非常敏感。WebMCP 的工具是在用户本地浏览器中执行的。AI 智能体调用的是本地函数,敏感数据(如用户当前的 Session 信息)不需要发送到云端。这符合"数据不出域"的合规大趋势。
5.2 AI 时代的 SEO:从"被看到"到"被调用"
过去我们做 SEO 是为了让百度/谷歌抓取我们的关键词。在 AI 时代,SEO 将进化为 "Agent Optimization"。
通过 WebMCP 声明工具,你的网站将变成一个"可编程的节点"。当用户问 AI:"帮我订一张去北京的票",AI 会直接调用你网页暴露的 book_ticket 工具,而不是带用户去搜链接。
5.3 跨平台一致性
WebMCP 磨平了不同 AI 平台(Gemini, Claude, GPT-4o-tools)与不同前端框架(Vue, React, Svelte)之间的鸿沟。你只需要写一套 registerTool,任何支持 WebMCP 的 AI 助手都能无缝使用。
六、 最新动态与未来展望
6.1 W3C 标准化进程
2025 年 2 月,W3C WebML 社区组发布了最新的 WebMCP 草案。Intel、Google 和 Microsoft 正在推动将 navigator.modelContext 固化到 Web IDL 中。这意味着它未来将像 fetch 或 navigator.geolocation 一样成为 Web 开发的基础设施。
6.2 框架集
目前,React 和 Next.js 的社区已经出现了针对 WebMCP 的自定义 Hook,如 useWebMCPTool。
JavaScript
// 假设的未来用法
useWebMCPTool('checkout', (cart) => {
// AI 触发结账逻辑
}, schema);
6.3 商业机会:AI 插件的终结者
以往我们为了给 AI 提供能力需要写 Chrome Extension。WebMCP 普及后,网站本身就是插件。只要用户打开你的网页,AI 就能立刻学会在该网页内操作。这对 SaaS 类产品、电商和企业内部工具是巨大的利好。
七、 结语
WebMCP 不仅仅是一个 API,它代表了 "Agentic Web(智能体化 Web)" 的到来。
作为一个资深开发者,现在开始在你的项目中尝试 WebMCP,意味着你正在为你的网站准备一张进入"机器友好型互联网"的入场券。不要再让你的 AI 智能体去辛苦地"抠"DOM 树了,给它一个标准的接口,让它像调用函数一样调用你的业务逻辑。
参考资源:
- W3C WebMCP 草案 (webmachinelearning.github.io/webmcp)
- Codely: What is WebMCP and how to use it
- The New Stack: Control AI Agents with JS
作者注: 如果你对 WebMCP 的安全性(如权限确认弹窗)或具体的 React 封装感兴趣,欢迎在评论区留言交流!