browser-mcp-control

用途

Browser MCP Control 是一个 Model Context Protocol（MCP）服务器，通过 Chrome 扩展将 AI 助手连接到本地 Chrome 浏览器，用于 AI 辅助的网页自动化。与无头自动化工具不同，它运行在用户现有的浏览器配置文件上，保留登录会话和 Cookie，从而减少 CAPTCHA 触发和机器人检测。

主要能力

该技能提供以下核心工具：

导航工具

browser_navigate：导航到指定 URL，可设置 waitUntil（load、domcontentloaded、networkidle）
browser_go_back / browser_go_forward：前进与后退
browser_wait：等待页面状态或指定秒数

交互工具

browser_click：通过 CSS 选择器或坐标点击元素，可指定按钮类型和点击次数
browser_type：向输入框输入文本，可选择输入后按回车提交
browser_select_option：选择下拉选项
browser_hover：悬停元素
browser_press_key：按下键盘按键（如 Enter、Escape、Tab 等）

检查工具

browser_snapshot：获取 ARIA 可访问性树（YAML 格式），返回结构化页面内容供 AI 分析
browser_screenshot：截取页面截图，可设置 JPEG 质量和是否全页，返回 base64 编码图像
browser_get_console_logs：获取浏览器控制台消息

使用方式

安装 MCP 服务器

git clone https://github.com/BrowserMCP/mcp.git
cd mcp
npm install
npm run build

配置 MCP 客户端（以 Cursor/Claude Desktop 为例）：

{
  "mcpServers": {
    "browsermcp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

VS Code 配置（.vscode/settings.json）：

{
  "mcp.servers": {
    "browsermcp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

安装 Chrome 扩展：从 browsermcp.io 或 Chrome Web Store 安装 Browser MCP 扩展。

连接扩展：重启 AI 客户端以启动 MCP 服务器；打开 Chrome 并点击 Browser MCP 扩展图标；在活动标签页点击 Connect；扩展通过 WebSocket 连接到 localhost:9009。

配置：在项目根目录创建 .env 文件，可设置 WS_PORT（默认 9009）、LOG_LEVEL，以及可选的 Redis 会话持久化参数（REDIS_ENABLED、REDIS_HOST、REDIS_PORT、REDIS_PASSWORD、REDIS_DB、REDIS_KEY_PREFIX、REDIS_SESSION_TTL_SECONDS）。

适用场景

网页抓取：在已认证状态下提取数据
表单自动化：填写多页表单
测试：使用真实浏览器验证 UI 工作流
研究：导航需要 JavaScript 的网站
数据收集：从受保护内容中收集信息
监控：检查站点状态并捕获证据

限制与注意事项

服务器仅在本地 localhost 运行，不向远程服务器发送数据
扩展需要用户在每个标签页显式连接
同一时间仅有一个扩展 WebSocket 连接处于活动状态
凭据应使用环境变量，切勿硬编码
若暴露端口，应设置 Redis 密码
常见问题包括扩展未连接、端口被占用、工具超时、无可用工具、Redis 连接失败等，文档提供了相应的排查方法
需要 Node.js 18+

技能介绍

用途

主要能力

使用方式

适用场景

限制与注意事项