WebMCP：把文件转换器变成AI智能体可调用的工具 — WebConverter

编辑注（2026-05）。Chrome 150 弃用了 navigator.modelContext，改用 document.modelContext（依据 WebMCP 规范 PR #184）。本文示例采用 Chrome 团队推荐的向前兼容的特性检测模式：

const modelContext = document.modelContext || navigator.modelContext;
if (modelContext) {
  // Register tools...
}

WebConverter 自身的集成正是使用了这一回退方案，因此在仍然提供旧标识符的浏览器中也能继续运行。

Model Context Protocol（MCP）标准化了AI智能体调用工具的方式。WebMCP把这个理念带到开放网络：网站本身不再需要单独的服务器进程，而是通过浏览器API — document.modelContext — 公开工具，浏览器内的智能体可以发现并调用它。我们刚刚为WebConverter发布了WebMCP集成，把网站能做的每一项转换都变成可由智能体调用的工具，而它仍然100%在你的浏览器中本地运行。

什么是WebMCP？

WebMCP是W3C Web Machine Learning Community Group的网络标准草案，由来自Google和Microsoft的工程师设计。它在浏览器的navigator对象上定义了一个新的入口点：document.modelContext。页面调用registerTool()来发布一个命名工具 — 带有描述和用于输入的JSON Schema — 并提供一个execute()函数，当工具被调用时由浏览器（或通过浏览器行事的智能体）调用。

与传统MCP的关键区别：没有单独的传输层，没有localhost服务器，没有需要管理的令牌。工具就是页面自身的JavaScript。对于隐私优先的转换器来说，这是决定性的 — 智能体获得了能力，但你的文件永远不会离开标签页。

为什么"File Converter MCP"很重要

今天，要求AI助手转换文件时，它通常只有三个糟糕的选择：把你的文件上传到第三方API、运行一个会接触你数据的服务器端工具，或者拒绝。一个由WebMCP驱动的转换器改变了这一权衡：无需上传，无需API密钥，无速率限制，无成本，而且由于上传—处理—下载的往返从未发生，碳排放接近于零。

我们公开的工具

WebConverter通过document.modelContext注册了两个工具：list_supported_formats，它返回可读取的输入格式和可写入的输出格式，以便智能体规划有效的转换；以及convert_image，它接收一个base64文件加目标格式，并将转换后的文件以base64和data:URL的形式返回。由于这些工具封装了现有的Worker流水线，图像转换器能做的任何事，智能体现在也能做。

我们如何构建它

该集成是一个在全站加载的小型延迟脚本。它定义工具描述符，在document.modelContext存在时用规范API注册它们，同时还公开一个镜像相同定义的小型程序化注册表 — 一个有文档记录的自动化接口，因此即使在尚未发布原生API的浏览器上，这些工具也可测试、可使用。整个实现都被包裹起来，使得缺失的Worker或被阻止的WASM永远不会向宿主页面抛出异常，而且它只增加了几千字节 — 没有新的WebAssembly。

关于信任与安全的说明

可由智能体调用的工具值得审视。WebConverter的工具在设计上是只读的：接收字节并返回字节。它们从不写入磁盘，从不发起网络请求，从不读取其他标签页，也从不持久化任何东西。调用convert_image的智能体所拥有的能力，与一个人点击"转换"完全相同 — 不多一丝一毫。

试试看

打开WebMCP页面，可以看到驱动convert_image工具的实时演示，以及工具模式的完整参考。如果你正在构建一个智能体，这就是一个诚实、私密、零成本的文件转换工具应有的样子 — 而它只是一个网页。