mcpField
B
browserdebug

browserdebug

本地服务
github.com/CloudCorpRecords浏览器自动化02 周前更新
代码仓库

关于 browserdebug

browserdebug 通过命令行工具和 stdio MCP 服务提供类似 Chrome DevTools 的网页调试功能，适用于配置了兼容 DevTools 协议的浏览器执行器的部署。软件本身不捆绑或下载浏览器。

主要功能

  1. 01记录并分析性能跟踪
  2. 02列出并检查网络请求
  3. 03读取控制台消息
  4. 04获取文本快照和截图
  5. 05模拟网络、CPU 和设备条件
  6. 06使用元素 UID 操作页面

适用场景

  1. 01通过性能跟踪调查页面表现
  2. 02检查网络请求和控制台输出
  3. 03获取页面文本或截图
  4. 04在模拟条件下测试页面

MCP 相关

stdio MCP 服务提供 26 种浏览器调试与交互工具，涵盖导航、性能、网络、控制台、快照、截图和输入。控制真实 Chrome 浏览器需要注入兼容 DevTools 协议的执行器。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-browserdebug": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/browserdebug"
      ]
    }
  }
}
启动命令npx -y @reneturcios/browserdebug

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/browserdebug0.1.0
ocighcr.io/cloudcorprecords/browserdebug:0.1.0

工具

26

收录的工具列表 · 更新于 2 周前

参数类型必填说明
uidstring是要点击的页面快照中元素的 uid
dblClickboolean否是否双击该元素

详细介绍

browserdebug

将 Chrome DevTools 风格的调试功能集成于一个二进制文件中，既可用作命令行工具，也可用作 stdio MCP 服务。记录性能跟踪并读取其分析结果，列出并检查网络请求，读取控制台消息，获取文本快照和截图，模拟网络、CPU 和设备条件，并通过元素 uid 操作页面输入。

浏览器位于可注入的执行器接口之后（src/types.ts 中的 DebugBrowser）。此软件包不捆绑也不下载浏览器：未配置执行器时，浏览器命令会失败，并显示清晰的“Browser unavailable”错误。部署时注入兼容 DevTools 协议的执行器，即可驱动真实的 Chrome。性能跟踪状态机位于核心中：必须先启动跟踪才能停止，且不能重复启动。

安装

npx -y @reneturcios/browserdebug mcp

命令行工具

browserdebug mcp
browserdebug pages
browserdebug navigate <url>
browserdebug snapshot
browserdebug screenshot [file]
browserdebug --version

退出代码：0 表示成功，1 表示浏览器错误，2 表示用法错误。

MCP 工具

26 个工具：click、drag、fill、fill_form、handle_dialog、hover、press_key、upload_file、close_page、list_pages、navigate_page、new_page、select_page、wait_for、emulate、resize_page、performance_analyze_insight、performance_start_trace、performance_stop_trace、get_network_request、list_network_requests、evaluate_script、get_console_message、list_console_messages、take_screenshot、take_snapshot。

MCP 客户端配置：

{
  "mcpServers": {
    "browserdebug": {
      "command": "npx",
      "args": ["-y", "@reneturcios/browserdebug", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/browserdebug          # MCP server
docker run --rm ghcr.io/cloudcorprecords/browserdebug --version

开发

npm install
npm run build
npm test

MIT 许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。