Browser MCP Lite

MCP浏览器工具

提供方 notoriouslab · 包名 browser-mcp-lite

浏览器工具 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

一个轻量级的MCP服务器,允许AI助手通过Chrome扩展读取页面、截图和运行脚本,同时保持现有登录会话。

一句话选型结论

按资料字段整理

Browser MCP Lite 属于浏览器工具类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 40 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

浏览器工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

浏览器自动化JavaScript本地部署AI助手集成MCP协议轻量级隐私保护

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx browser-mcp-lite

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

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

抓取结构化数据

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

关键流程回归

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

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Browser MCP Lite当前 4 stdio · 本地进程 本地部署 有 2026-05-17
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方notoriouslab上游标注的维护方 notoriouslab
分类浏览器工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时browser-mcp-lite · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.6 KB
来自项目仓库与上游目录的原文,未做删改

浏览器mcp-lite

繁体中文 |英语

让你的AI助手看到你的真实浏览器——大约500行代码。

最低限度的身份验证安全 主控程序 该服务器允许AI助手在您的实际Chrome浏览器中阅读页面、截图和运行脚本,而您现有的登录会话保持不变。```
AI Assistant ──HTTP POST──▶ MCP Server (:12307) ──WebSocket──▶ Chrome Extension ──▶ DOM
(token auth) (ws://) (minimal permissions)


## 为什么要建立自己的?

现有的浏览器MCP解决方案有:

- **太重了** — mcp铬 需要 `debugger`, `history`, `` 权限,发送您无法审核的压缩代码
- **仅限无头** — 剧作家MCP 启动新浏览器,看不到您登录的会话
- **依赖云** --Browserbase等通过第三方服务器路由您的页面

浏览器mcp-lite采用了不同的方法:

||mcp chrome|剧作家mcp| **浏览器mcp-lite** |
|---|---|---|---|
|读取您的真实浏览器|是|否(无头)| **是** |
|MCP端点上的身份验证|否|否| **令牌身份验证** |
|扩展权限|8+|N/A| **5(最小)** |
|您可以审计的代码|精简|是| **~500条线路** |
|登录会话|是|否| **是** |

## 它做什么

通过标准MCP协议公开的四种工具:

|工具|描述|返回|
|------|-------------|---------|
| `list_tabs` |列出所有打开的选项卡| `[{id, url, title, active}]` |
| `read_page` |将页面读取为可访问性树|结构化文本(令牌高效)|
| `screenshot` |捕获可见区域|Base64 PNG图像|
| `inject_script` |在选项卡中运行自定义JS |脚本返回值|

## 快速启动

### 1.安装并启动服务器

**选项A--npx(不需要克隆):**```bash
npx browser-mcp-lite

选项B--克隆:```bash
git clone https://github.com/notoriouslab/browser-mcp-lite.git
cd browser-mcp-lite/server
npm install
node index.js


第一次运行时,会自动生成一个令牌。服务器打印完整的令牌和一个准备粘贴的配置块:```
[browser-mcp-lite] MCP server: http://127.0.0.1:12307/mcp
[browser-mcp-lite] WebSocket:  ws://127.0.0.1:12307/ws

⚠ First run — new token generated

━━━ Auth Token (paste into Chrome Extension popup) ━━━

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

━━━ MCP Client Config (save as .mcp.json) ━━━
{
"mcpServers": {
"browser": {
"type": "http",
"url": "http://127.0.0.1:12307/mcp",
"headers": {
"Authorization": "Bearer "
}
}
}
}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[browser-mcp-lite] Waiting for Chrome Extension...

2.加载Chrome扩展程序

  1. 打开 chrome://extensions/
  2. 启用 开发人员模式 (右上)
  3. 点击 装载时未包装 → 选择 extension/ 文件夹
  4. 单击工具栏中的浏览器MCP Lite图标
  5. 复制终端中打印的令牌并将其粘贴到 授权令牌 领域
  6. 点击 连接

分机自动连接。单击工具栏图标以验证绿点。

3.连接您的AI助手

> 注: 准备粘贴 .mcp.json 服务器启动时,config会打印在终端中。

Claude Code

添加到您的项目 .mcp.json:```json
{
"mcpServers": {
"browser": {
"type": "http",
"url": "http://127.0.0.1:12307/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}


替换 `YOUR_TOKEN_HERE` 令牌打印在终端中。

Claude Desktop

添加 `~/Library/Application Support/Claude/claude_desktop_config.json`:```json
{
"mcpServers": {
"browser": {
"type": "http",
"url": "http://127.0.0.1:12307/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}

Cursor / VS Code

在光标中:设置→ MCP → 添加服务器:

  • 姓名: browser
  • 类型: http
  • 网址: http://127.0.0.1:12307/mcp
  • 标题: Authorization: Bearer YOUR_TOKEN_HERE

建筑

三个组成部分```

┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ AI Assistant │ │ MCP Server │ │ Chrome Extension │
│ (any MCP client) │────▶│ (Fastify) │────▶│ (Manifest V3) │
│ │HTTP │ :12307/mcp │ WS │ │
│ │POST │ Token auth │ │ tabs, scripting, │
│ │◀────│ │◀────│ activeTab, alarms │
└─────────────────┘ └──────────────────┘ └──────────────────┘


**MCP服务器** (`server/index.js`,约150行)

- 使用以下命令加速HTTP服务器 `@modelcontextprotocol/sdk` 可流式HTTP传输
- 对每个请求进行令牌身份验证(来自 `~/.browser-mcp-secrets.json`)
- Chrome扩展程序通信的WebSocket端点
- 每会话MCP传输管理

**Chrome 扩展** (`extension/background.js`,约215行)

- 清单V3服务工作者
- 带有保活警报的WebSocket客户端(在MV3 Service Worker终止后仍然有效)
- 通过Chrome API直接实现这四个工具
- 服务器重新启动时自动重新连接

**可访问性树生成器** (`extension/inject/accessibility-tree.js`,约195行)

- 注入目标页面以构建结构化DOM表示
- 输出 `ref_*` 每个交互/结构元素的ID
- 比原始HTML更具令牌效率——AI可以在不燃烧上下文的情况下推理页面结构

### 为什么使用可访问性树而不是原始HTML?

一个典型的网页有50-200KB的HTML。同一页面的可访问性树为2-10KB-- **小10-50x**。它去掉了样式、脚本和装饰元素,只保留了重要的东西:标题、链接、按钮、输入及其标签。```
# Raw HTML: ~150KB

Settings

# Accessibility tree: ~50 bytes
[ref_42 link "Settings" href=/settings]

安全性设计

  • 令牌认证(两层):MCP端点需要 Authorization: BearerWebSocket端点要求在连接时进行令牌握手。两者都使用相同的令牌 ~/.browser-mcp-secrets.json.
  • 最低权限:只有 tabs, activeTab, scripting, alarms, storage不 debugger,没有 history,没有 cookies,没有 webRequest.
  • 仅限本地主机:服务器绑定到 127.0.0.1。未暴露于网络。
  • 无网络代理:该扩展永远不会使用您的浏览器Cookie发出HTTP请求。它只读取DOM并截图。
  • 手动扫描:需要时启动服务器,完成后按Ctrl+C。没有守护进程,没有自动启动。
  • 可审计的:总共约500行。10分钟内读完。

保密考虑

> 注意你向你的人工智能助手暴露了什么。

  • list_tabs 将所有打开的标签URL和标题发送给AI助手。如果你打开了敏感页面(电子邮件、医疗、私信),它们的网址和标题将可见。
  • screenshot 捕获屏幕上的任何内容,包括密码、个人数据或私人内容。
  • screenshot 切换选项卡:Chrome浏览器 captureVisibleTab API只能捕获活动选项卡。如果截屏背景选项卡,它将被短暂切换到前台。

快速注射风险:恶意网页可能包含隐藏文本,诱使您的AI助手调用 inject_script 其他选项卡上有有害代码。在批准工具调用之前,请务必对其进行审查。不自动批准 inject_script 电话。

缓解措施:仅在需要时运行服务器。使用前请关闭敏感选项卡。查看您的AI助手可以通过以下方式查看的内容 list_tabs 在调用其他工具之前。切勿在MCP客户端中自动批准工具调用。

MV3服务人员生存

Chrome的Manifest V3会在大约30秒的不活动后终止Service Workers。该扩展使用 chrome.alarms 以24秒的间隔保持活动状态,并在需要时重新连接WebSocket。

定制

更改端口:```bash
MCP_PORT=9999 node index.js


在中更新WebSocket URL `extension/background.js` 第5行和 `extension/popup.html` 因此。

**添加新工具:**

编辑 `server/tools.js` 注册新的MCP工具,并在中添加相应的处理程序 `extension/background.js`s `handleToolRequest` 开关。

## 它是如何工作的(对于好奇的博客文章)

1. 启动MCP服务器(`node index.js`).它在听 `:12307` 用于HTTP(MCP)和WebSocket(扩展)。
1. Chrome扩展程序的Service Worker连接到 `ws://127.0.0.1:12307/ws`.
1. 您的AI助手发送MCP请求(例如。, `read_page`)to `http://127.0.0.1:12307/mcp` 持有Bearer代币。
1. 服务器验证令牌,将MCP调用转换为WebSocket消息,并将其发送到扩展。
1. 扩展执行对应的Chrome API调用(例如。, `chrome.scripting.executeScript` 注入可访问性树构建器)。
1. 结果返回:扩展→ 网络套接字→ 服务器→ http响应→ AI助手。

整个往返需要100-500ms,具体取决于页面的复杂性。

## 现实世界的例子

看 `examples/web-architectures.md` 了解从不同web架构读取数据的详细演练,这些架构包括基于iframe的传统门户、React/Angular SPA、Vue.js动态站点、AJAX密集型仪表板和CSP严格页面。

## 运行测试```bash
node --test tests/server.test.js

测试包括:健康检查、令牌认证(丢失/错误/有效)、MCP协议握手和会话管理。

文件结构```

browser-mcp-lite/
├── server/
│ ├── index.js # Fastify MCP Server + WebSocket hub
│ ├── tools.js # Tool schemas + handlers (4 tools)
│ ├── token.js # Shared token generation/loading
│ ├── setup.js # One-time token generator
│ └── package.json
├── extension/
│ ├── manifest.json # Manifest V3, minimal permissions
│ ├── background.js # Service Worker: WS client + tool implementations
│ ├── popup.html # Connection status UI
│ ├── popup.js
│ ├── inject/
│ │ └── accessibility-tree.js # DOM → structured text
│ └── icons/
├── examples/
│ └── web-architectures.md # Handling different web architectures
├── tests/
│ └── server.test.js # Server auth + protocol tests
├── LICENSE
├── README.md # English
└── README.zh-TW.md # 繁體中文
```

需求

  • Node.js 18+
  • Chrome或基于Chromium的浏览器
  • 任何兼容MCP的AI客户端

许可证

麻省理工学院

学分

可访问性树方法的灵感来自 人向性/人向性流沙.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Browser MCP Lite 怎么安装?

在客户端按下面的安装命令接入:npx browser-mcp-lite。对应的包名是 browser-mcp-lite。装完在客户端配置里引用同一个包或端点。

Browser MCP Lite 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Browser MCP Lite 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Browser MCP Lite 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Browser MCP Lite 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Browser MCP Lite 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 浏览器自动化、轻量级、JavaScript、Claude、隐私保护。具体工具清单以官方文档为准。

Browser MCP Lite 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Browser MCP Lite 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。