ysunyang4/webagent
AI 工程把网页版大模型对话页接入本机 Nexus MCP 工具的浏览器扩展,支持工具调用与结果回填。
项目介绍
WebAgent 是一个 Chromium 内核浏览器扩展,在支持的网页版大模型对话页顶部加入浮动控制面板,并把对话页与本机运行的 Nexus MCP 服务桥接起来。它不依赖模型 API Key,而是复用用户已登录的网页会话,覆盖 DeepSeek、Gemini、ChatGPT、Kimi、通义千问、豆包、智谱系页面和 Google AI Studio 等。
扩展会解析模型输出的 nexus 工具调用代码块,转成本地 MCP 请求,调用文件读写、命令执行、网页快照等工具,再把结果填回聊天输入框。适合已经在本机运行 Nexus 项目、又想直接用网页版模型操作本地工具的用户;项目权限由用户在扩展内控制。
快速使用
- 下载或克隆仓库到本地。
- 在 Chrome 打开
chrome://extensions/(Edge 为edge://extensions/),开启开发者模式,点击「加载已解压的扩展程序」,选择项目文件夹。 - 本机启动 Nexus 并注册项目。默认服务地址是
http://127.0.0.1:8787,请求路径为/mcp,也支持本机 18080、21888 端口。 - 在扩展弹窗填写 MCP 地址、已注册的项目 ID 和工作目录,然后检测连接。项目 ID 与工作目录初始为空。
- 打开受支持的对话页,页面顶部会出现 WebAgent 浮动卡片。从面板复制增强协作协议,由用户自己发送给 AI。
- 按需在弹窗打开「自动执行工具」和「自动发送结果」。两个开关独立,默认都关闭。
更新扩展后先保存草稿,再重新加载扩展并刷新 AI 网页。更完整的说明见详细使用指南,版本变化见更新日志。
使用约束
- 扩展只连接获准的本地 loopback 地址,不包含第三方遥测。工具结果回填到第三方 AI 网页后,该网页可以读取结果,因此不要通过它传递凭证、密钥等敏感内容。
- 项目文件和命令权限只能从扩展弹窗修改,且需要独立的 Nexus 管理令牌;它不是 Bridge Token,也不是网页 AI 的 API Key。网页内容无法提升权限。
- 「项目代码执行」不是操作系统级沙箱,命令仍可能影响项目之外的资源。
- 熔断保护默认开启,连续工具调用默认上限为 20 轮。关闭后不再按轮次、重复结果或连续失败暂停,但不会改变任何权限。
- 开启自动发送时,输入框里已有的草稿也会一并发送;首次开启会提示。
- 运行测试需要 Node.js 22+,命令为
npm test。原创代码采用 GPL-3.0-only 许可证。
HotRepo 点评
在 2026-11-16 记录到的新项目快照中,WebAgent 进入 JavaScript 新项目榜,累计 105 星、28 Fork,在约 1.5 小时的统计窗口内新增 5 星、2 Fork。观察窗口很短,不足以判断趋势。项目文档提到 136 项测试,以及另外验证过的 Gemini「模型输出 → MCP 执行 → 反馈自动发送」闭环,这让它不只是一个交互面板,还给出了可供核查的测试范围。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。