<p align="center"><img src="extension/icons/icon-128.png" width="88" height="88" alt="WebMCP Script 小鸟标志"></p>
<h1 align="center">WebMCP Script</h1>
<p align="center">让 AI 使用网页工具，让网站脚本可以自由分享。</p>
<p align="center"><a href="https://github.com/Yuyang-Hou/webmcp-script/releases/tag/v0.4.0-beta.1">下载公测版</a> · <a href="docs/getting-started.md">安装与首次使用</a> · <a href="https://github.com/Yuyang-Hou/webmcp-script/issues/new/choose">反馈问题</a></p>

**0.4.0-beta.1 · 开发者公测**。Chrome 扩展负责管理独立 `.user.js` 脚本，本机 MCP 服务把网页原生 WebMCP 工具提供给 AI。网站已有工具和脚本补充的工具走同一条原生发现与调用链路。

目前通过下载源码、本机构建、加载已解压扩展安装，尚未上架 Chrome Web Store。适合愿意使用实验性浏览器能力的开发者，暂不承诺普通稳定版 Chrome 开箱即用。

## 可以做什么

- 查看当前网页的工具，已识别的来源按页面或脚本展示。
- 粘贴标准用户脚本，使用 CodeMirror 编辑；保存前预览网站范围，支持启停、删除和上一版恢复。
- 脚本直接使用 `document.modelContext.registerTool`，不必依赖项目专属接口。
- 连接支持 stdio MCP 的 AI 客户端，发现页面、读取工具 schema、执行经过用户授权的操作。
- 在扩展图标查看本页工具数量和连接异常；多个 AI 任务共享本机连接。

![管理面板](docs/manager.png)

界面截图使用 example.com 测试数据，不代表该网站实际提供这些工具。

## 开始公测

需要 **Node.js 22+、pnpm 9.15.9，以及启用 WebMCP 的 Chromium**。本项目实测 Chromium 153；安装扩展所需的 userScripts API 与原生 WebMCP 是两个不同条件。

1. 下载上方公测版的源码 ZIP，解压到固定目录；或者克隆指定版本：

   ```sh
   git clone --branch v0.4.0-beta.1 https://github.com/Yuyang-Hou/webmcp-script.git
   cd webmcp-script
   pnpm install --frozen-lockfile
   pnpm build
   ```

   使用 ZIP 时，在解压后的项目目录执行最后两条命令。pnpm 未安装时先执行 `npm install -g pnpm@9.15.9`。

2. 在浏览器开启 WebMCP 测试功能，再加载 `dist/extension` 并允许用户脚本。[逐步安装指南](docs/getting-started.md)包含具体入口和排错方法。
3. 扩展 → 管理面板 → **连接** → 复制连接说明发给 AI，再粘贴 AI 返回的连接码。
4. 请 AI 调用 `pages` 检查页面。首次验证可使用本地示例，避免用业务写操作试连通性。

构建会写入这台电脑的 Node 和 MCP 入口绝对路径；请保留安装目录，移动目录后重新构建。连接码仅用于本机配对，不能分享。更新时见[升级与退出公测](docs/getting-started.md#升级与退出公测)。

## 公测边界

| 范围 | 状态 |
|---|---|
| Chrome 扩展、脚本编辑与 MCP 桥接 | 本次公测主入口 |
| 原生发现、调用与脚本停用清理 | 已有自动化与隔离浏览器验证；归属范围见脚本格式说明 |
| Windows / Linux 用户桌面 | 尚未完整人工验收；Linux CI 不等于用户桌面验收 |
| Codex 内置浏览器 | 实验路线，依赖特定 macOS 隔离副本与启动方式，不属于开箱即用支持 |
| 热更新 | 普通脚本更新或重新启用后需刷新页面；声明式包需重新生成并重载 |
| 脚本兼容性 | 支持所列元数据，不是完整油猴实现，不支持全部 GM API |

浏览器未提供原生接口时会报“不支持”，不会以自建工具表冒充原生 WebMCP。只管理当前文档工具，不汇总跨源 iframe。调用超时或断线可能意味着结果未知，不自动重放；脚本可读取和修改匹配页面，工具可调用不等于业务操作已获授权。

## 文档与维护

[脚本格式与模板](SCRIPT_FORMAT.md) · [隐私与数据流](PRIVACY.md) · [安全报告](SECURITY.md) · [参与贡献](CONTRIBUTING.md) · [更新记录](CHANGELOG.md) · [路线图](ROADMAP.md) · [开发与实验方案](docs/development.md) · [AI 脚本管理](docs/ai-script-management.md)

源码采用 MIT 许可证；依赖许可见 [THIRD_PARTY.md](THIRD_PARTY.md)。本项目为独立社区项目，与 Google、OpenAI 没有官方隶属关系。