开发者在文档页内嵌 MCP 服务器:13 个工具直连浏览器 Agent,附 Chrome 153 踩坑
DavidAntoon · reddit · 2026-10-27
FrontMCP(开源 TypeScript MCP 框架)维护者分享在文档站启用 WebMCP 的一手实践:通过浏览器 API document.modelContext,网页可直接向浏览器里的 AI Agent 注册工具,替代截图-点击式交互。
核心思路
- 传统方式 Agent 需截图、找搜索框、点击、再截图,6 步操作;WebMCP 下 Agent 直接调 searchdocs({query})、getpage 拿 Markdown,2 次调用拿到结构化数据
- 工具在页面内运行,天然带上登录态与屏幕上下文,无需额外部署服务器或登录
- 站点掌握主动权:只暴露提供的工具,schema 校验输入,hint 标注只读工具
站点部署的 13 个工具:searchdocs、getpage、getversion、getcurrentpage、navigate、runinplayground(Web Worker 沙箱编译运行代码,60 秒上限)等,其中 6 个可读写页面 Playground。
成本账:三步加载——每页检测 API 是否存在;idle 时注册 5.4KB(压缩后)的工具清单;Agent 首次调用才加载约 540KB 完整服务,首次调用 311ms,后续 1-4ms。作者踩过坑:早期版本页面加载即启动,导致 Lighthouse 每次评估 2.7MB 脚本、约 360ms TBL。
Chrome 153 的坑:
- 工具抛错时 Chrome 对 Agent 隐藏错误信息,只给 UnknownError,要传达的内容必须写进 result
- getTools() 不返回 consequentialHint,别指望它让 Agent 先询问
- Chrome for Testing(Lighthouse 所用)默认开启 WebMCP,测试工具看到的页面不同
「编程与Agent」频道最新
- 用 Claude 做出极简可爱风 DAW,降低音乐制作门槛 — Educational-Theme185 · 2026-10-27
- 用 Claude Opus 4.5 加 UE5 重渲染《鸣潮》场景,效果惊艳 — Eric520CC · 2026-10-27
- AEGIS 开源 MCP 网关:一次性审批绑定精确参数防误调用 — Leather_Tour_794 · 2026-10-27
- 测试者实测 8 个月首遇翻车:OpenBot 智能体无视用户拒绝强改设置 — Teknium · 2026-10-27
- Renoise MCP 发布:让 Codex 自动剪辑出专业级宣传视频 — vista8 · 2026-10-27
- AEGIS 开源 MCP 网关:为 agent 每次工具调用要求一次性精确审批 — Leather_Tour_794 · 2026-10-27