WebMCP Today

WebMCP Today MCP Bridge

@webmcp-today/mcp-bridge 是一个面向 WebMCP Today 的 MCP 服务：WebMCP Today 是一个软件包注册表，可通过 WebMCP Today 浏览器扩展为受支持的网站添加 WebMCP 工具。

它支持 MCP 客户端浏览和发布注册表软件包、管理账户级软件包固定项；如果已安装可选的本地浏览器桥接程序，还可以发现并调用用户所选浏览器标签页中的实时 WebMCP 工具。

安装和配置

需要 Node.js 20 或更高版本。将任何支持 stdio 的 MCP 客户端配置为使用 npx 运行此软件包：

{
  "mcpServers": {
    "webmcp-today": {
      "command": "npx",
      "args": ["--yes", "@webmcp-today/[email protected]"]
    }
  }
}

默认注册表为 https://webmcp.today。仅在使用其他兼容的注册表端点时才设置 WEBMCP_TODAY_API_URL。

注册表 API 密钥（可选）

发现公开软件包无需凭据。在 MCP 服务环境中设置 WEBMCP_TODAY_API_KEY，即可使用需要身份验证的账户和发布者操作，包括固定软件包、发布软件包和更新软件包元数据。在 WebMCP Today 设置中创建 API 密钥；请勿将其放入提示词、软件包定义或源代码管理中。

{
  "mcpServers": {
    "webmcp-today": {
      "command": "npx",
      "args": ["--yes", "@webmcp-today/[email protected]"],
      "env": {
        "WEBMCP_TODAY_API_KEY": "<your-api-key>"
      }
    }
  }
}

功能

该服务提供以下类别的工具：

• 注册表发现 — 按 URL 查找软件包、浏览软件包、获取最新版本的软件包，以及查看注册表统计信息。
• 账户和发布 — 查看和管理账户级软件包固定项；发布软件包并追加版本；更新软件包元数据。这些操作需要 API 密钥。账户固定项不会在浏览器中安装软件包；返回的安装链接会将这一步明确的浏览器授权操作交由用户完成。
• 实时 WebMCP 桥接 — 列出并聚焦用户所选的可见 Chrome 或 Brave 标签页，列出其中的实时工具，并使用发现操作返回的文档和工具列表版本执行所选工具。
• 桥接管理 — 在受支持的 macOS 浏览器上安装、检查和移除官方原生桥接程序。

实时浏览器桥接

实时桥接为可选功能，需要 WebMCP Today 扩展，以及在 macOS Chrome 或 Brave 上完成官方原生主机设置。配置 MCP 服务后，明确批准并调用 setup_webmcp_bridge，例如：

{ "browser": "chrome", "confirm": true }

设置过程会将打包的原生主机复制到 ~/.config/webmcp-today 下，并仅在浏览器的 Application Support 目录中写入此桥接程序的原生消息传递清单。Brave 会写入自己的清单和一份 Chrome 兼容清单。它可在 Node 20 或更高版本或 Bun 上运行。使用 get_webmcp_bridge_status 检查安装情况，不会暴露桥接密钥。

此桥接程序仅对用户所选的当前活动且可见的 Chrome 或 Brave 标签页进行操作。它不会启用 WebMCP、运行任意 JavaScript、代理 Chrome DevTools Protocol 或开放 HTTP 端口。由注册表注入的工具会使用页面经过身份验证的 Cookie 发起同源页面请求，因此可以使用已登录的网站账户执行操作。页面仍可能拒绝注入的 WebMCP 工具；如果在发现与执行之间更改了页面或其工具，则必须重新进行发现。

扩展的本地回退模式可通过此桥接程序提供工具，无需启用当前的 WebMCP 测试标志。但要让 Chrome 的原生 Agent 在当前浏览器预览中看到注入的工具，仍需启用该标志。

确认与重试

• 由注册表注入且标记为破坏性操作的工具会保留页面级 window.confirm 提示；请在选中的标签页中确认。
• setup_webmcp_bridge 和 uninstall_webmcp_bridge 在调用时传入 confirm: true 之前不会进行任何文件系统更改。
• 出现 execution-timeout 时，浏览器可能已完成工具调用：请先核实结果再重试。dispatch-failed 表示调用未被分发，可以重试。
• 卸载 Brave 时会有意保留其 Chrome 兼容性清单。请按照工具报告的说明，在关闭两个浏览器后运行已确认的 Chrome 卸载操作，然后再认为桥接程序已完全移除。

开发

开发此仓库时，请安装依赖并运行软件包测试：

bun install
bun run --filter @webmcp-today/mcp-bridge test

链接

• WebMCP Today
• 源代码
• 问题反馈
• MIT 许可证