Brave DevTools MCP

面向 Agent 的 Brave DevTools

完整兼容 Chrome DevTools MCP，并为 Brave 重新打造。

brave-mcp 让 Claude Code、Codex、Cursor、OpenCode 和其他 MCP 客户端能够直接访问 Brave，用于浏览器自动化、网络和控制台调试、性能分析、屏幕截图、无障碍检查和内存分析。此外还包含一个独立的 brave-devtools CLI。

一条命令即可安装

以下命令使用 --autoConnect，将 brave-mcp 连接到已打开的 Brave，因此 Agent 可以使用你实际打开的标签页和已登录的会话。只需启用一次：在 Brave 中打开 brave://inspect/#remote-debugging，然后勾选 允许对此浏览器实例进行远程调试。Brave 会在重启后保留此设置。

Claude Code

claude mcp add brave-devtools --scope user -- npx -y brave-mcp@latest --autoConnect

Cursor

cursor --add-mcp '{"name":"brave-devtools","command":"npx","args":["-y","brave-mcp@latest","--autoConnect"]}'

Codex

codex mcp add brave-devtools -- npx -y brave-mcp@latest --autoConnect

OpenCode

opencode mcp add brave-devtools -- npx -y brave-mcp@latest --autoConnect

重启客户端，然后尝试使用以下提示词：

在 Brave 中打开我的应用。查找控制台错误和失败的网络请求，检查无障碍树，运行 Lighthouse，并说明影响最大的问题。

Agent 连接时，Brave 会请求授权。点击 允许。

除非添加 --channel beta 或 --channel nightly，否则 --autoConnect 会连接到 Brave Release。若要避免 Agent 使用你的日常浏览器，请省略 --autoConnect：此时服务会使用专用配置文件启动独立的 Brave。

为什么选择它，而不是 Chrome DevTools MCP？

功能	brave-mcp	chrome-devtools-mcp
原生启动并发现的浏览器	Brave Release、Beta 和 Nightly	Chrome Stable、Beta、Dev 和 Canary
连接到现有浏览器	Brave 配置文件、HTTP 或 WebSocket	Chrome 配置文件、HTTP 或 WebSocket
上游 DevTools 功能	完全兼容；目前仅落后 0 次提交	源码实现
使用遥测	默认禁用	默认启用
独立 CLI	brave-devtools	chrome-devtools

当目标浏览器是 Chrome 时，请使用 Chrome DevTools MCP。当目标浏览器是 Brave，且你希望使用 Brave 原生的发现机制、配置文件、渠道、命名和隐私默认设置，同时不放弃上游功能时，请使用 brave-mcp。

工具参考 | 更新日志 | 参与贡献 | 故障排查 | 设计原则

主要功能

• 获取性能洞察：使用 Chrome DevTools 记录跟踪数据， 并提取可操作的性能洞察。
• 高级浏览器调试：分析网络请求、截取屏幕截图，并检查浏览器控制台消息（包含源映射的堆栈跟踪）。
• 可靠的自动化。使用 puppeteer 自动执行 Brave 中的操作，并自动等待操作结果。

免责声明

brave-mcp 会向 MCP 客户端公开浏览器实例的内容，使其能够检查、调试和修改浏览器或 DevTools 中的任何数据。 请勿分享你不希望 MCP 客户端访问的敏感信息或个人信息。

brave-mcp 官方支持当前版本的 Brave。Beta 和 Nightly 渠道可显式选择。

性能工具可能会向 Google CrUX API 发送跟踪网址，以获取真实用户的体验数据。这有助于将现场数据与实验室数据一并呈现，从而全面了解性能情况。这些数据由 Chrome 用户体验报告（CrUX）收集。如需停用此功能，请使用 --no-performance-crux 标志运行。

使用统计

此分支默认停用使用统计数据收集功能。可以使用 --usage-statistics 显式启用，该选项使用上游 Google Clearcut 实现：

"args": ["-y", "brave-mcp@latest", "--usage-statistics"]

启用后，Google 会按照 Google 隐私权政策处理这些数据。如果设置了 BRAVE_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI，则仍会停用数据收集。

更新检查

默认情况下，服务会定期检查 npm registry 是否有更新，并在有较新版本时记录通知。 如需停用更新检查，请设置 BRAVE_DEVTOOLS_MCP_NO_UPDATE_CHECKS。

要求

• Node.js LTS 版本。
• 当前版本或更新版本的 Brave。
• npm

入门

在 brave://inspect/#remote-debugging 中启用一次远程调试，然后将以下配置添加到 MCP 客户端，以连接正在运行的 Brave：

{
  "mcpServers": {
    "brave-devtools": {
      "command": "npx",
      "args": ["-y", "brave-mcp@latest", "--autoConnect"]
    }
  }
}

说明

使用 brave-mcp@latest 可确保 MCP 客户端始终使用最新版 Brave DevTools MCP 服务。

省略 --autoConnect，即可让服务使用专用配置文件启动自己的 Brave。

如果你只想执行基本的浏览器任务，请使用 --slim 模式：

{
  "mcpServers": {
    "brave-devtools": {
      "command": "npx",
      "args": ["-y", "brave-mcp@latest", "--slim", "--headless"]
    }
  }
}

请参阅 Slim 工具参考。

MCP 客户端配置

有关适用于你的编辑器或 Agent（例如 Antigravity、Claude Code、Cursor、VS Code）的设置说明，请参阅客户端配置指南。如需连接正在运行的 Brave，请在其中列出的服务参数中添加 --autoConnect。

你的第一个提示词

在 MCP 客户端中输入以下提示词，检查一切是否正常：

Check the performance of https://brave.com

Brave 会要求你允许连接。点击 允许后，MCP 客户端会在 Brave 中打开页面并记录性能跟踪数据。

说明

MCP 服务仅会在 MCP 客户端首次使用需要浏览器的工具时连接 Brave，而不是在客户端启动时连接。如果未使用 --autoConnect，此时服务会启动自己的 Brave。

工具

如果遇到问题，请查看我们的故障排除指南。 如需查看所有受支持 MCP 功能的完整列表，请参阅工具参考。

配置

有关完整的服务参数列表（例如 --headless、--isolated、--slim）以及 WebSocket 连接的配置方法，请参阅配置指南。

高级用法

有关处理并发会话、持久化用户数据目录、连接到正在运行的 Brave 实例而非启动新实例，或在 Android 上进行调试等高级功能，请参阅我们的高级用法指南。

已知限制

请参阅故障排除。

集成为浏览器子 Agent

如果你正在开发 Agent 工具，并希望将集成式浏览器子 Agent 作为产品的一部分提供，我们建议基于面向 Agent 的 Brave DevTools 进行构建。

如需参考实现，请参阅 Gemini CLI 浏览器 Agent 文档。