Browser Navigator MCP

一个模型上下文协议（MCP）服务器，通过 CDP（Chrome DevTools 协议）让 AI 助手完全控制 Brave 浏览器。专为 OSINT 调查、社交媒体爬取和通用 Web 自动化而构建。

附加到您现有的 Brave 实例（或启动一个新的实例），不会触碰您的标签页——它连接的是浏览器，而不是克隆副本。

功能特性

• 🧭 完全浏览器控制 — 导航、点击、输入、滚动、悬停、截图、PDF 导出

• 🪟 窗口与标签页管理 — 列出、打开、切换、关闭窗口/标签页

• 🔐 CAPTCHA 检测 — 自动检测 reCAPTCHA、hCaptcha、Cloudflare Turnstile 及挑战，然后等待人工解决

• 🍪 会话持久化 — 保存/加载 Cookie，保持登录状态在多次运行间有效

• 🎥 视频控制 — 在任何 HTML5 播放器（YouTube 等）上播放/暂停/跳转/调节音量

• 🔍 社交搜索 — 一键搜索 Google、X/Twitter、Instagram、Facebook、LinkedIn、TikTok、YouTube

• 🔧 任意 JavaScript — 通过 execute_js 执行其他操作（需显式确认标志）

• 🏥 健康检查 — 确认服务器与浏览器连接状态

环境要求

• Node.js 20+

• Brave 浏览器（安装在标准路径，或通过 BRAVE_PATH 指定）

• 无需下载 Playwright 浏览器——服务器直接通过 CDP 驱动 Brave

安装

git clone <your-repo-url>
cd brave-browser-mcp
npm install

快速开始

1. 使用调试端口启动 Brave

./launch-brave.sh

这将使用 --remote-debugging-port=9222 启动 Brave。它绝不会终止现有的 Brave 实例——如果端口 9222 已被占用，它会保持原样。

或者，手动启动 Brave：brave --remote-debugging-port=9222。 如果 Brave 已在运行但没有调试端口，MCP 会要求您关闭它并重试——它不会替您终止正在运行的浏览器。

2. 运行服务器

node index.js

服务器通过 stdio 进行 MCP 通信。connect_brave 会自动附加到正在运行的 Brave 实例。

3. 将其注册为 MCP 服务器

对于 opencode，添加到 opencode.json：

{
  "mcp": {
    "browser-navigator": {
      "type": "local",
      "command": ["node", "index.js"],
      "cwd": "/absolute/path/to/brave-browser-mcp",
      "enabled": true
    }
  }
}

对于 Claude Desktop，添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "browser-navigator": {
      "command": "node",
      "args": ["/absolute/path/to/brave-browser-mcp/index.js"]
    }
  }
}

工具

CAPTCHA 处理

在 navigate / navigate_history 之后，CAPTCHA 会被自动检测，并在 get_page_info 中报告。当发现未解决的 CAPTCHA 时，自动化会暂停并请求用户在浏览器中解决——此工具不能（也不会）绕过它们。

检测类型：reCAPTCHA、hCaptcha、Cloudflare Turnstile、Cloudflare Challenge。

安全说明

• execute_js 需要 confirm=true，且限制为 5000 字符 / 50KB 输出。

• 截图和 Cookie 路径已针对路径遍历进行清理。

• Cookie 以 0o600 权限存储，目录以 0o700 权限存储。

• 服务器绝不会终止它未启动的浏览器。

• 有关完整的安全与代码质量审计，请参阅 AUDIT.md。

测试

测试套件通过真实的 MCP stdio 协议驱动服务器（需要 Brave 在端口 9222 上运行）：

node test.cjs

53 个断言，涵盖导航、CAPTCHA、标签页、窗口、截图、Cookie、视频和安全加固。

许可证

PolyForm Noncommercial 1.0.0 — 请参阅 LICENSE。

可免费用于任何非商业目的（个人、研究、教育、爱好、慈善、政府）。如需商业使用，请先联系作者——在商业使用本项目之前，请先与我们联系。