MCP Chrome Skill

通过本地 MCP 服务 (http://127.0.0.1:12306/mcp) 控制用户的真实 Chrome 浏览器。

工作原理

mcp-chrome-bridger 是一个运行在本地的 MCP 服务器，通过 Chrome 扩展与 Chrome 浏览器通信。

• MCP 服务地址: http://127.0.0.1:12306/mcp
• 传输方式: SSE (Server-Sent Events)
• Stdio 模式: /usr/local/lib/node_modules/mcp-chrome-bridger/dist/mcp/mcp-server-stdio.js
• 安装路径: /usr/local/lib/node_modules/mcp-chrome-bridger/

平台配置

Claude Code (CLI)

已在 ~/.claude/settings.json 中配置，MCP 工具可直接调用。

OpenClaw / QClaw

需要在 ~/.openclaw/mcp.json 中添加此配置：

{
  "mcpServers": {
    "mcp-chrome": {
      "type": "http",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

健康检查

在调用任何工具前，先检查服务是否运行：

# 检查 mcp-chrome-bridger 是否运行
lsof -i :12306 | grep LISTEN

如果服务未运行，启动它：

# 启动 mcp-chrome-bridger（已注册为系统服务）
launchctl start com.mcpchromeserver.nativehost 2>/dev/null || \
  curl -fsSL https://kimi-web-img.moonshot.cn/webbridge/install.sh | bash

工具使用速查表

使用场景

查看浏览器当前状态

// 调用 get_windows_and_tabs() 查看当前打开的窗口和标签页

打开网页并获取内容

// 1. chrome_navigate({url: "https://example.com"})
// 2. chrome_get_web_content({})  // 获取当前页面文本

表单填写与点击

// 1. chrome_get_interactive_elements({})  // 获取可交互元素
// 2. chrome_fill_or_select({selector: "#input-id", value: "text"})
// 3. chrome_click_element({selector: "#submit-btn", waitForNavigation: true})

对 Shadow DOM 元素操作

对 Reddit 等使用 Web Components 的网站，添加 useCDP: true：

chrome_click_element({
  coordinates: {x: 100, y: 200},
  useCDP: true
})

搜索历史记录

chrome_history({
  text: "搜索关键词",
  startTime: "1 day ago",
  maxResults: 20
})

注意事项

1. 总是先调用 get_windows_and_tabs 了解浏览器当前状态
2. 截图使用 storeBase64: true 直接查看页面内容
3. 对于复杂编辑器（Lexical、ProseMirror 等），fill_or_select 添加 useCDP: true
4. 点击后如果页面会跳转，设置 waitForNavigation: true
5. 批量操作使用 chrome_batch 提高效率
6. 注入脚本时 type 只能是 ISOLATED 或 MAIN