MCP Devtools Browser

MCP浏览器工具

提供方 4bd4ll4h

浏览器工具 未标注 无需鉴权 社区 / 第三方 Cursor

一个基于Model Context Protocol (MCP)的服务器,为LLM提供使用Puppeteer的浏览器自动化能力,包括页面导航、DOM检查、网络监控等功能。

一句话选型结论

按资料字段整理

MCP Devtools Browser 属于浏览器工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

浏览器自动化TypeScript本地部署网络监控DOM检查数据提取Puppeteer

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

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

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

抓取结构化数据

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

关键流程回归

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

选择建议

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

值得选的地方

  • 已适配 Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Devtools Browser当前 未标注 未标注 未标注 无 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

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方4bd4ll4h上游标注的维护方 4bd4ll4h
分类浏览器工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

面向开发人员的DevTool Broswer

> 一个强大的模型上下文协议(MCP)服务器,使用Puppeteer为LLM提供浏览器自动化功能。

🚀 快速开始```bash

npm install -g @4bd4ll4h/mcp-devtools-browser


添加到MCP客户端配置中:```json
{
"mcpServers": {
"devtools-browser": {
"command": "npx",
"args": ["@4bd4ll4h/mcp-devtools-browser"]
}
}
}

✨ 特性

  • 浏览器自动化:打开、导航和控制浏览器页面
  • DOM检查:以可访问性为重点提取结构化DOM数据
  • 网络监控:捕获和分析网络请求
  • 事件日志记录:全面的会话跟踪和调试
  • 用户交互:单击、键入、滚动、悬停等
  • 视觉捕捉:屏幕截图和视觉分析
  • 资源管理:自动清理和内存管理

📖 文档

  • api参考 -完整的工具和资源文档
  • 示例 -使用示例和教程
  • 开发指南 -架构和贡献指南
  • 贡献 -如何为这个项目做出贡献

🤝 贡献

我们欢迎捐款!请阅读我们的 贡献指南 和 行为准则.


项目规范

项目概述

该项目旨在建立一个 模型上下文协议(MCP) 协助LLM生成 高质量、可靠的网络抓取脚本 使用 TypeScript+Puppeter.

MCP将充当以下之间的受管网关:

  • 真实的浏览器环境(Puppeteer)
  • 页面生命周期事件(请求、响应、选择器、DOM状态)
  • LLM的任务是理解页面并生成抓取操作

目标:

> 允许LLM自主探索页面、检查网络流量、提取DOM节点路径/选择器,并根据需要生成健壮的抓取脚本。


核心用例

  1. 从任何网站提取数据
  • 提供、产品、表格、PDF、元数据、图像
  1. 网络智能
  • 检测后端API调用
  • 推断JSON数据结构
  • 将结构化数据优先于渲染的HTML
  1. 动态DOM检查
  • 选择稳定的选择器
  • 滚动并缓慢加载内容
  • 处理影子DOM、iframe、modals

为什么选择MCP?

MCP提供:

  • 结构化双向工作流
  • 使用模式对操作进行建模
  • 更好的编排
  • 可重复性

它能够构建 LLM驱动的刮擦剂.


主要技术挑战

该系统必须解决:

✅ 向LLM展示类似DevTools的见解

  • 网络请求/响应
  • 标题、正文、错误代码

✅ DOM可见性大

  • 没有过载令牌限制

✅ 强大的有状态浏览

  • 标签页
  • 导航历史记录
  • 并行提取

高级体系结构```

LLM <--> MCP Server <--> Puppeteer Controller
|
├── Browser Pool (multi-page sessions)
├── Network Listener
└── DOM Snapshot Manager


______________________________________________________________________

## **关键组件**

### 1. **浏览器管理器**

责任:

- 启动/停止浏览器实例
- 创建新选项卡
- 关闭选项卡
- 报告会话信息

建议:

- 维护一个以以下方式键入的内部注册表 `sessionId`
- 每个LLM对话一个会话

### 2. **选项卡/页面管理器**

对于每一页:

- 导航
- 单击、键入、滚动、等待选择器
- 保存屏幕截图
- 保持页面状态

推荐:

- 限制最大打开标签
- 自动清理资源

### 3. **网络拦截器**

目标:

- 捕获所有XHR/接听电话
- 检查响应
- 确定API终点
- 检测潜在的结构化数据源

MCP工具操作:

- `getNetworkRequests()`
- `filterRequestsBy(url · type · status)`
- `fetchResponseBody(requestId)`

### 4. **DOM检查器**

挑战:
页面可能很大;LLM令牌限制适用。

方法:

#### **A.DOM分块**

将DOM拆分为切片:

- 按深度
- 按视觉视口
- 按选择器路径

#### **B.选择器聚光灯**

LLM请求:

- 突出显示悬停元素或查询的可能选择器

#### **C.CSS路径生成**

自动计算:

- CSS选择器
- 路径表达式
- 强大的启发式选择器

______________________________________________________________________

## **建议LLM面对MCP行动**

### 导航

- `navigate(url)`
- `goBack()`
- `goForward()`

### DOM查询

- `querySelector(selector)`
- `querySelectorAll(selector, limit)`
- `extractAttributes(selector, attrs[])`
- `getBoundingClientRect(selector)`
- `scroll(amount)`
- `scrollToBottom()`

### 网络

- `listNetworkRequests(type?)`
- `getRequestDetails(requestId)`
- `getResponseBody(requestId)`

### 截图

- `captureScreenshot(mode=viewport|full)`

### 调试

- `printConsoleLogs()`
- `printNetworkErrors()`

### 效用

- `generateSelectorsAtPoint(x,y)`

______________________________________________________________________

## **浏览器/选项卡生命周期策略**

### 会话规则

- 每个MCP会话都会创建 **一个浏览器实例**
- 标签被注册和跟踪
- 硬限制(例如5)以避免内存崩溃

### 垃圾回收

- 空闲选项卡&gt;N分钟→ 自动关闭
- 关闭会话结束时的所有选项卡

### 选项卡标识

返回结构化选项卡状态:```json
{
&quot;tabId&quot;: &quot;abc123&quot;,
&quot;url&quot;: &quot;...&quot;,
&quot;title&quot;: &quot;...&quot;,
&quot;loading&quot;: false
}

展示类DevTools功能

方法A——Chrome DevTools协议事件

用途:

  • page.on(&#x27;request&#x27;)
  • page.on(&#x27;response&#x27;)
  • page.on(&#x27;console&#x27;)

赞成的意见:

  • 实时
  • 低开销

方法B——拦截和存储网络历史

店铺:

  • 方法
  • 统一资源定位符
  • 状态
  • 请求体
  • 响应大小/正文提示

稍后让LLM过滤。

方法C——按类型过滤

  • XMLHttpRequest
  • 获取
  • 媒体
  • 样式表
  • 脚本

可用于目标发现。

推荐:全部三个。


使大型DOM LLM友好

方法A——语境分块

按以下方式拆分DOM:

  • 可见部分
  • 语义区域(`

,

`)

方法B——仅限选择者摘要

与其转储HTML,不如提供:```
selector -> value summary


例子:```
.OfferTitle -&gt; &quot;Summer Sale&quot;
.OfferPrice -&gt; &quot;$19.99&quot;

方法C——按需快照

LLM问:

> “给我‘products’容器的DOM”

您仅使用本地化的HTML进行响应。

推荐

A+C组合。


您建议的方式(评估)

优势

✔ 监控请求捕获隐藏的API
✔ DOM提取支持视觉抓取
✔ 拦截生命周期提供完整性

弱点/风险

⚠ 转储完整DOM=令牌爆炸
⚠ JSON响应可能很大
⚠ 网络日志太多→ noise
⚠ LLM的重复结构混乱

潜在的质量问题

  • 选择器不稳定性(动态类)
  • 无限的滚动复杂性
  • 事件时间问题
  • CSP屏蔽截图

我们将使用启发式和检测规则来缓解这些问题。


推荐的选择器稳定性启发式方法

  1. 首选:
  • data-* 属性
  • 语义HTML
  • 母链
  1. 避免:
  • 混淆的类名
  • 自动生成的ID
  1. 验证:
  • 该选择器在滚动事件中匹配一致的计数

脚本生成哲学

水平回退顺序:

  1. 结构化API JSON(最佳)
  2. 语义HTML
  3. 计算DOM文本
  4. 视觉刮擦(最严重)

LLM应使用此层次结构进行操作。


MCP工具模式示例

示例操作:列出网络请求```ts

{
"name": "listNetworkRequests",
"arguments": {
"type": "xhr",
"status": 200,
"contains": "offers"
}
}


### 示例操作:查询DOM```ts
{
&quot;name&quot;: &quot;querySelectorAll&quot;,
&quot;arguments&quot;: {
&quot;selector&quot;: &quot;.offer-card&quot;,
&quot;limit&quot;: 20,
&quot;attributes&quot;: [&quot;href&quot;, &quot;innerText&quot;]
}
}

LLM工作流示例

  1. 导航到目标URL
  2. 监控JSON端点的网络
  3. 请求目标区域的DOM快照
  4. 选择稳定的选择器
  5. 在TS中生成可重用的抓取脚本
  6. 在多个页面上测试选择器(如果分页)
  7. 输出结构化结果

错误处理策略

  • 暴露结构化错误
  • 包括堆栈痕迹
  • 通知LLM瞬态故障

例子:```json
{
"error": "SelectorNotFound",
"selector": ".price",
"attempts": 3
}


______________________________________________________________________

## **将来的扩展**

- PDF下载
- 文件元数据提取
- 可访问性树刮擦
- 快照差异检测
- 会话重放

______________________________________________________________________

## **安全考虑**

- 不允许导航 `localhost` 端口
- 默认情况下禁用下载
- 清理文件输出路径
- 删除敏感请求标头

______________________________________________________________________

## **技术栈**

**语言**:TypeScript
**浏览器自动化**:木偶
**协议**:MCP
**状态存储**:内存映射
**解析器工具**:

- DOM遍历工具
- CSS/XPath生成器库

______________________________________________________________________

## **文件夹结构(建议)**```
/src
/mcp
actions/
schemas/
router.ts
/browser
BrowserManager.ts
PageManager.ts
NetworkTracker.ts
DomInspector.ts
utils/
index.ts
types.ts

成功标准

✅ LLM可以:

  • 检查网络通话
  • 安全地读取DOM结构
  • 导航选项卡
  • 识别稳定的选择器
  • 生成健壮的脚本

✅ 代理人:

  • 避免完整的DOM转储
  • 尽可能使用API端点
  • 可靠地提取结构化结果

最终目标

一个完全自主的抓取助手,可以:

  • 发现数据源
  • 生成弹性提取逻辑
  • 生成Types/Node脚本
  • 处理动态web应用程序

准备建造

现在Cursor AI有:

  • 全局上下文
  • 建筑
  • 最佳实践启发式
  • 风险
  • 工作流
  • 预期API

此文件应支持智能上下文感知编码辅助。

让我知道你什么时候准备好了:

  • 规范脚手架
  • MCP动作定义
  • Puppeter包装器实现
  • 选择器启发式
  • JSON模式合约

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Devtools Browser 怎么在 Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Devtools Browser 收费吗?

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

MCP Devtools Browser 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Devtools Browser 支持哪些客户端?

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

MCP Devtools Browser 能提供哪些能力?

资料显示能力标签包括 浏览器自动化、数据提取、TypeScript、Cursor、网络监控。具体工具清单以官方文档为准。

热门专题

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

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