AutoBrowser MCP

Browser MCP

Browser MCP 可让 AI 应用（Claude Code、Cursor、VS Code、Codex、Claude Desktop……）使用你自己的 Chrome：已登录的网站、个人资料，以及专属标签页。所有操作都在你的电脑上运行。

• 网站和文档：browsermcp.io，文档
• 扩展程序：Chrome Web Store，或自行构建
• MCP 服务：npm 上的 @browsermcp/mcp

工作原理

每个 AI 应用都会运行 MCP 服务（npx @browsermcp/mcp@latest）。这是一个小型进程，它会为每位用户启动一个守护进程，并将应用对 browser 工具的调用转发给该进程。守护进程通过扩展程序使用 Playwright 操控浏览器标签页：扩展程序是一个轻量的 chrome.debugger 中继，只与 127.0.0.1 上的守护进程通信，而且每台电脑只需在弹出窗口中点击一次 Allow，并确认六位数代码与 AI 应用显示的代码一致后，才会开始通信。无论守护进程提出什么请求，扩展程序都会执行自己的规则：不允许使用无痕模式、浏览器或扩展程序页面；按下 Stop 后不执行任何操作。

文件夹	软件包
packages/mcp	@browsermcp/mcp	MCP 服务和守护进程（README）
packages/protocol	@browsermcp/protocol	扩展程序与守护进程之间的协议，包括配对
packages/extension-core	@browsermcp/extension-core	扩展程序的浏览器控制功能：连接、配对、调试器中继、标签页规则、标签组和徽章
apps/extension	@browsermcp/extension	基于此仓库构建的扩展程序：浏览器控制功能及其弹出窗口

自行构建

你需要 Node.js 24 或更高版本、pnpm（corepack enable）以及 Chrome 或其他 Chromium 浏览器（Edge、Brave、Arc……）。Firefox 没有 debugger API，因此 Browser MCP 无法在其中运行。

1. 构建扩展程序和服务：

   git clone https://github.com/BrowserMCP/mcp.git browsermcp
   cd browsermcp
   pnpm install
   pnpm build
   

2. 打开 chrome://extensions，开启开发者模式，点击加载已解压的扩展程序，然后选择 apps/extension/.output/chrome-mv3。它的名称是“Browser MCP (self-built)”。如果同一浏览器个人资料中安装了 Chrome Web Store 上的 Browser MCP，请将其关闭，因为同一时间只能有一个扩展程序使用该服务。

3. 在 AI 应用的 MCP 配置中，运行你构建的服务，而不是 npm 上的版本：

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

   npx @browsermcp/mcp@latest（文档中的配置方式）也适用于此扩展程序：这是同一个服务，发布自此仓库。

4. 重启 AI 应用，并让它在浏览器中执行某项操作。首次使用时，扩展程序的弹出窗口会要求你 Allow 此电脑上的服务：请确认其中的代码与 AI 应用显示的代码一致。

此扩展程序的所有构建版本都使用相同的 ID（imlplcjlhgpajopdbpbngiadkcmdbgob，来自 apps/extension/extension-key.ts 中的 key），服务也接受 Chrome Web Store 版本的 ID。使用其他密钥构建的版本，必须将其 ID 添加到服务环境中的 BROWSER_MCP_EXTENSION_IDS（以逗号分隔），或者写入 ~/.browsermcp/dev-extension-ids 的一行中。

更新

git pull
pnpm install
pnpm build

然后，点击 chrome://extensions 中“Browser MCP (self-built)”旁的重新加载按钮。如果 AI 应用从此文件夹运行服务，也请重启 AI 应用。扩展程序和服务会在对方版本过旧、无法兼容时通知你。

开发

• pnpm lint、pnpm format（pnpm format:fix 可修复问题）：Oxlint 和 Oxfmt。
• pnpm typecheck、pnpm test：对每个软件包运行 TypeScript 检查和单元测试（Vitest）。服务端测试使用 Playwright 的 Chromium：运行 pnpm --filter @browsermcp/mcp exec playwright-core install chromium 安装一次即可。
• pnpm smoke：以开发模式构建扩展和服务端，在无头 Chromium 中加载扩展，并通过服务端驱动扩展，模拟 AI 应用的操作。该命令使用随机端口和临时的 BROWSER_MCP_HOME，因此不会接触你自己的 Browser MCP。截图保存在 apps/extension/.output/smoke/。
• pnpm --filter @browsermcp/extension build:dev：开发构建（apps/extension/.output/chrome-mv3-dev）。

贡献与安全

请参阅 CONTRIBUTING.md，了解如何报告 Bug 和提交更改；如需私下报告漏洞，请参阅 SECURITY.md。

许可证

Apache-2.0。“Browser MCP”及其徽标是本项目的商标：如果你发布修改后的扩展或服务端，请使用不同的名称和图标（TRADEMARKS.md）。