Claude 与 Skill
用 Bruster 给 Claude Code 装上浏览器:一个能跑通的 MCP 教程
Bruster 是一个用 Rust 写的开源浏览器控制器,内置 MCP server,不依赖 Node.js,直接调用系统原生 webview。作者演示了从安装、注册到让 Claude Code 自动填表、校验结果并截图的完整流程,步骤可复现,还附了常见故障排查表。
今天就能做
- 挑你应用里一个表单,按教程装 Bruster 并注册到 Claude Code,从'期望看到的最终结果'倒推让 agent 执行的操作序列
- 写提示词时强制要求 agent 读取提交后的页面状态并逐项核对,而不是只报告点击动作
- 需要保留登录态时加 --profile 参数,但注意它是独立 profile,不会继承日常浏览器会话
Bruster 是什么、为什么轻量
- 开源 Rust 项目,内置 MCP server,通过 stdio 与 Claude Code 通信
- 使用平台原生 webview:macOS 用 WKWebView,Linux 用 WebKitGTK,Windows 用 WebView2
- 不需要 Node.js 运行时,启动快、依赖少
安装与环境准备
- macOS/Linux 一行脚本安装:curl 安装脚本后把 ~/.local/bin 加入 PATH
- Ubuntu/Debian 需补装 libwebkit2gtk-4.1-0
- 无桌面的 Linux 服务器装 xvfb 和 xauth,隐藏模式下 Bruster 会在 DISPLAY 缺失时自动启动 Xvfb
- Windows 走 WebView2,用官方指南里的对应安装包和客户端配置
跑通示例:起服务、注册 MCP
- clone 仓库后用 python3 -m http.server 8765 在本地起一个演示表单页
- 用 claude mcp add --transport stdio bruster -- 绝对路径 --mcp --quiet 注册,-- 后面是 Bruster 自己的参数
- 默认注册范围是当前项目本地;用绝对路径可避免终端 PATH 与 MCP 启动环境不一致
- 进 Claude Code 后运行 /mcp 确认连接状态
给 Claude 一个可验证的任务
- 示例提示词:打开页面、先检查表单结构、填入姓名和项目名、勾选选项、读取实时 JSON 预览确认四个值、点击提交后核对回执内容
- 关键在于让 agent 读取结果状态并汇报,而不是只说'我点了按钮'
- 典型工具链:navigate → snapshot → fill_form → text → click → text → screenshot
- 回执应包含提交的姓名、选项和 Screenshots: on,任何一项不符都要报告失败
可见模式与持久会话
- 想看浏览器窗口,重新注册时在 --mcp 后加 --visible,改完注册要重启 Claude Code
- 加 --profile 参数可让 cookie 和 storage 在多次运行间保留,但它是独立 profile,不会复用你日常浏览器的登录态
常见问题与适用边界
- Claude 启动不了 Bruster:先 command -v bruster 确认,注册时用绝对路径
- Linux 加载不了浏览器:装 WebKitGTK 4.1;无显示环境补 Xvfb 和 xauth
- 页面打不开:Python 服务要保持运行,MCP 进程要能访问本机 loopback
- 连接失败无报错:去掉 --quiet 让原生错误打到 stderr
- 它用合成 DOM 事件,依赖可信输入或跨域 iframe 的页面可能操作不了;需要多引擎可选 Playwright MCP,完整回归测试另选测试框架
原文:Claude Code browser automation with Bruster: a working MCP tutorial
来源:DEV Community · 2026-11-10
查看原文本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论