MCP Server · 浏览器工具

Brower Control MCP

Browser MCP是一个本地运行的浏览器自动化工具，通过MCP协议和Chrome扩展实现AI应用对浏览器的自动化控制，适用于需要隐私保护的本地自动化场景。

未说明官方级别未说明来源级核验工具 13

浏览器自动化JavaScriptClaude隐私保护Claude DesktopCursorWindsurfVS Code

快速开始

公开资料没有提供安装命令，按仓库或官方文档接入。

打开主来源页面 GitHub 仓库

作者 / 组织: shashank-100
提供方: shashank-100

工具数量

来源目录标注

资源数量

来源目录标注

提示词数量

来源目录标注

GitHub Star

仓库热度

收录来源

1 个

MCP World

选型结论

Brower Control MCP 属于浏览器工具类 MCP Server，公开资料标注 13 个工具，通过传输方式未标注接入，适配 Claude Desktop、Claude、Cursor，没有现成的安装命令；接入前先确认权限范围。

分类

浏览器工具

传输方式

未说明

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

公开目录没有给出安装命令，需要按仓库 README安装；下面按同类条目的通用流程说明。

公开命令不是通用的启动方式，拼不出可靠配置示例；请在客户端 MCP 配置里按官方文档填写 command 和 args。

上手步骤

1
先确认运行方式
公开资料没有标注传输方式，先看仓库 README，确认是本地进程还是远程地址。
2
获取服务
公开目录没有给出安装命令，按仓库 README里的步骤安装或获取服务。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 13 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

公开资料仍需确认：安装命令

详细介绍

浏览器MCP

浏览器MCP是一个MCP（模型上下文协议）服务器+Chrome扩展程序，允许您使用VS Code、Claude、Cursor和Windsurf等AI应用程序自动化浏览器。

特性

⚡ 快速：自动化在您的机器上本地进行，从而在没有网络延迟的情况下获得更好的性能。

🔒 私人：由于自动化发生在本地，您的浏览器活动将保留在设备上，不会发送到远程服务器。

👤 登入：使用您现有的浏览器配置文件，保持您登录所有服务。

🥷🏼 隐形：通过使用真实的浏览器指纹来避免基本的机器人检测和验证码。

建筑

该项目由两部分组成：

MCP服务器 （此存储库）：通过模型上下文协议提供浏览器自动化工具
Chrome 扩展 （必填）：通过WebSocket将浏览器连接到MCP服务器

服务器通过本地WebSocket连接（默认端口：9003）与Chrome扩展程序通信，确保所有自动化都发生在您的本地计算机上，而不会将数据发送到外部服务器。

快速开始

1.安装依赖关系并构建

npm install
npm run build

2.安装Chrome扩展程序

打开Chrome浏览器并导航到 chrome://extensions/
启用“开发人员模式”（在右上角切换）
点击“加载解包”
选择 extension 此存储库中的目录
将扩展固定到工具栏（可选但推荐）

3.启动MCP服务器

npm run dev

服务器将启动并等待浏览器扩展连接。

4.连接分机

在Chrome中单击浏览器MCP扩展程序图标
扩展应自动连接到服务器
您应该看到带有绿色徽章的“已连接”状态

5.配置克劳德桌面

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

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

替换 /absolute/path/to/brower-control-mcp/dist/index.js 你的实际路径。

6.重新启动克劳德桌面

重新启动Claude Desktop以加载MCP服务器。现在，您可以让Claude自动化您的浏览器！

详细文件

使用指南 -完整的设置和配置说明
扩展指南 -Chrome扩展程序文档

用法

运行服务器

npm run dev

或者在建造之后：

node dist/index.js

Claude桌面配置

将此添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

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

Chrome 扩展

附带的Chrome扩展程序将您的浏览器连接到MCP服务器：

位置: extension/ 此存储库中的目录
安装：在Chrome中作为解压缩的扩展程序加载（请参阅快速入门）
连接：自动连接到 ws://localhost:9003
状态：单击扩展图标检查连接状态

看扩展名/README.md 详细文档。

可用工具

导航工具

导航：导航到URL
go返回：返回浏览器历史记录
goForward：在浏览器历史记录中前进

交互工具

点击：通过CSS选择器或ARIA标签单击元素
悬停：将鼠标悬停在元素上
类型：在输入元素中键入文本
select选项：在下拉列表中选择一个选项
拖拽：将一个元素拖动到另一个元素

检测工具

快照：使用ARIA快照捕获当前页面状态
截图：截取当前页面的屏幕截图
getConsoleLogs：检索浏览器控制台日志

实用工具

等待：等待指定的秒数
按键：按键盘键（例如Enter、Escape、ArrowDown）

发展

项目结构

src/
├── index.ts              # Main entry point
├── server.ts             # MCP server setup
├── context.ts            # WebSocket connection manager
├── ws.ts                 # WebSocket server creation
├── tools/
│   ├── tool.ts          # Tool type definitions
│   ├── common.ts        # Navigation tools
│   ├── custom.ts        # Screenshot and console tools
│   └── snapshot.ts      # Interaction tools
├── resources/
│   └── resource.ts      # Resource type definitions
└── utils/
    ├── port.ts          # Port management utilities
    └── snapshot.ts      # ARIA snapshot capture

构建和开发脚本

npm run build：构建项目
npm run watch：观看模式用于开发
npm run typecheck：无建筑类型检查
npm run dev：构建并运行服务器
npm run inspector：运行MCP检查器进行调试

运作原理

MCP服务器启动并在端口9003上创建WebSocket服务器
Chrome扩展程序连接到WebSocket服务器
AI应用程序（Claude、VS Code等）通过stdio与MCP服务器通信
当调用工具时，MCP服务器通过WebSocket向浏览器发送命令
扩展程序在实际浏览器中执行命令
捕获结果（ARIA快照、屏幕截图等）并返回给AI

该架构确保：

本地执行：一切都在你的机器上运行
真实浏览器：将您的实际Chrome个人资料用于所有登录
隐私：没有数据离开您的设备
隐形：真正的浏览器指纹，而不是无头自动化工具

协议消息

服务器通过WebSocket使用JSON消息与浏览器扩展进行通信：

请求格式

{
  "type": "browser_click",
  "selector": "#submit-button"
}

响应格式

{
  "type": "browser_click_response",
  "data": { "snapshot": "..." },
  "error": null
}

支持的消息类型

browser_navigate / browser_navigate_response
browser_go_back / browser_go_back_response
browser_go_forward / browser_go_forward_response
browser_click / browser_click_response
browser_hover / browser_hover_response
browser_type / browser_type_response
browser_select_option / browser_select_option_response
browser_drag / browser_drag_response
browser_press_key / browser_press_key_response
browser_screenshot / browser_screenshot_response
browser_get_console_logs / browser_get_console_logs_response
browser_capture_snapshot / browser_capture_snapshot_response

安全与隐私

所有自动化都在您的机器上本地进行
没有数据发送到外部服务器
WebSocket连接仅限于本地（127.0.0.1）
使用您现有的浏览器配置文件和凭据
完全控制AI可以访问的内容

故障排除

“未连接到浏览器扩展”错误

确保：

Chrome扩展程序已安装并启用
扩展已连接（检查扩展图标）
MCP服务器正在运行
没有防火墙阻止端口9003

端口已在使用中

启动时，服务器会自动终止使用端口9003的任何进程。如果您发现问题：

检查是否有其他实例正在运行
尝试在中更改端口 src/ws.ts

鸣谢

该项目改编自微软的Playwright MCP服务器，重新聚焦于自动化现有的用户浏览器，而不是创建新的自动化实例。

许可证

麻省理工学院

工具与能力

工具数量

资源数量

提示词数量

能力标签

浏览器自动化JavaScript本地部署本地执行隐私保护AI集成Chrome扩展

支持客户端

Claude DesktopClaudeCursorWindsurfVS Code

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

自动操作网页

打开页面、点击、填表，把浏览器动作交给模型执行。

抓结构化数据

把页面内容整理成表格或 JSON，省掉手工复制粘贴。

走一遍关键流程

按步骤检查页面是否正常，回归时少漏环节。

选择建议

值得选的地方

工具数量 13 个，一次接入能覆盖的操作比单点工具更全。
已经适配 Claude Desktop、Claude、Cursor，换客户端不用重新研究配置。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

公开资料没有可直接复制的安装命令，第一次接入要自己找入口。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在浏览器工具场景里让模型直接调用外部能力的人。
已经在用 Claude Desktop 的用户，接入路径最短。
愿意照着官方文档一步步配环境的人。

不太适合

希望一条命令就装好、不想看文档的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Brower Control MCP MCP World · 本页	13	未说明	未标注	1 个	2026-05-17
Fetch 9a2682de MCP.so	1	SSE	有	3 个	2026-05-17
Browser 738d52bc MCP World	0	stdio	有	1 个	2026-05-17
Playwright MCP Server MCP.so	21	stdio	有	4 个	2026-05-17
Skyvern MCP MCP World	0	stdio	有	2 个	2026-05-17

常见问题

5 条