WebMCP 是什么

WebMCP（Web Model Context Protocol）由 W3C Web Machine Learning 社区组提出，是一套运行在浏览器内的 Web 标准提案，让网站可以把自己的功能——既可以是 JavaScript 函数，也可以是 HTML <form> 表单——以「工具（tool）」的形式暴露出来，并配上自然语言描述和结构化 JSON Schema。AI 智能体（内置在浏览器、运行在 iframe 或扩展里）发现这些工具后，就能像调用函数一样去驱动网页，而不再靠截图、DOM 爬取或模拟点击这种脆弱又低效的方式。

一个很形象的比喻：把 WebMCP 当成餐厅里的菜单，是网站主动、现成地端给 AI 的「菜品清单」。用户（或智能体）照着菜单点单，网站自己用已有的前端代码把活干完，页面状态始终可见、可控、可回溯。也就是网站主动把能力发布给 AI，这正是它区别于传统后端 MCP / OpenAPI 集成的关键。

如何开启（实验特性）

该功能目前处于测试阶段，需在 Chrome 中手动开启：

chrome://flags/#enable-webmcp-testing

将 Enable WebMCP testing 设为 Enabled 后重启浏览器即可体验。

解决的痛点

与后端集成（如 MCP、OpenAPI）相比，WebMCP 避免了三个问题：后端绕过前端会丢失共享上下文与可见状态；开发者必须另搭服务器去复制用户状态、会话与凭证；智能体直接驱动 UI 时，截图/DOM 模拟点击既慢又易碎。WebMCP 通过复用页面已有的客户端代码，让「用户能用手点的操作」瞬间变成「智能体能调用的工具」，实现 code reuse 与人机闭环（human-in-the-loop）。

核心能力

• 命令式 API：document.modelContext.registerTool()，传入 name、description、inputSchema 与 execute 回调。
• 声明式 API：从 <form> 元素自动合成工具，无需写代码。
• 权限与 iframe：顶层窗口/同源 iframe 默认开启；跨源 iframe 通过 allow="tools" 委派，Permissions-Policy: tools=() 可关闭。
• 跨源暴露：exposedTo: ["https://origin"] 把工具共享给指定安全源。
• 发现与执行：页内智能体用 getTools() / executeTool() 调用。
• 取消与动态更新：AbortSignal 支持中途取消；toolchange 事件在工具增删改时触发。
• TypeScript 类型：webmcp-types npm 包提供类型定义。

生命周期

注册（页面调用 registerTool）→ 发现（智能体查询浏览器拿到工具与 Schema）→ 调用（传结构化参数）→ 执行（浏览器在页面上下文触发 execute 回调）→ 返回（结构化结果，如 { content: [{ type: "text", text: "..." }] }）。

典型场景

README 给出了多个用例：创意设计（Easely）、电商（Wildebloom）、开发者工作流（Gerrit 代码评审）等，均附代码示例。其设计目标定位为「协作式工作流」，而非完全自治或替代后端。

提案与生态

提案仓库：https://github.com/webmachinelearning/webmcp ，首次发布于 2025 年 8 月，当前约 3.9k stars、259 forks。规范由 Dominic Farolino 等社区成员主导演进，相关 prior art 包括 MCP、MCP-B、OpenAPI、A2A。