Browserdebug

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 7, 2026

Debug web pages in Chrome: performance traces, network, console, snapshots, screenshots.

已验证STDIO仅桌面浏览器自动化开发者工具

概览

AI 生成的概览

为助手提供 Chrome DevTools 式网页调试：操作页面、录制性能追踪，并查看网络、控制台、快照与截图。

可以做什么
  • 导航、打开、选择与关闭页面，并等待指定文本出现
  • 点击、悬停、拖拽、填写输入框与表单、按键、处理对话框、上传文件
  • 获取基于无障碍树的文本快照，以及页面或元素的截图
  • 启动与停止性能追踪，并查看某条追踪洞察的详细信息
  • 列出并查看当前页面的网络请求与控制台消息
  • 模拟网络、CPU、地理位置、User-Agent 与配色方案，调整窗口尺寸，并在页面中执行 JavaScript
适用场景
适合需要复现或诊断网页问题的场景：查看控制台报错、追踪加载缓慢、检查网络请求，或针对真实 Chrome 会话执行表单填写与点击流程。
运行要求
通过 npx 或 Docker 镜像以 stdio 在本地运行。该包不内置也不下载浏览器；未注入兼容 DevTools 协议的执行器时，浏览器相关命令会以“Browser unavailable”错误失败。未声明认证、环境变量或请求头。
安装前请注意
这些工具会操作真实浏览器：点击、输入、提交表单、上传文件、执行 JavaScript 并更改模拟设置，可能改动数据或在访问的网站上触发操作。上传文件会把本地文件内容发送到页面。性能追踪与网络检查会把页面数据暴露给助手。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Browserdebug，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

browserdebug

Chrome DevTools-style debugging as a CLI and a stdio MCP server in one bin. Record performance traces and read their insights, list and inspect network requests, read console messages, take text snapshots and screenshots, emulate network/CPU/device conditions, and drive page input by element uid.

The browser sits behind an injectable executor interface (DebugBrowser in src/types.ts). This package bundles no browser and downloads none: with no executor configured, browser commands fail with a clear "Browser unavailable" error. Deployments inject a DevTools-protocol-compatible executor to drive a real Chrome. The performance-trace state machine lives in the core: a trace must be started before it can be stopped, and cannot be started twice.

Install

bash
npx -y @reneturcios/browserdebug mcp

CLI

bash
browserdebug mcpbrowserdebug pagesbrowserdebug navigate <url>browserdebug snapshotbrowserdebug screenshot [file]browserdebug --version

Exit codes: 0 success, 1 browser error, 2 usage error.

MCP tools

26 tools: 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 client config:

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

Docker

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

Development

bash
npm installnpm run buildnpm test

MIT license.

来源：README.md，提交 6fe938b

工具

26

click

Click on the provided element

输入参数uid必填dblClick

drag

Drag an element onto another element

输入参数to_uid必填from_uid必填

fill

Type text into an input, text area or select an option from a select element

输入参数uid必填value必填

fill_form

Fill out multiple form elements at once

输入参数elements必填

handle_dialog

Handle a browser dialog (accept or dismiss)

输入参数action必填promptText

hover

Hover over the provided element

输入参数uid必填

press_key

Press a key or key combination in the browser

输入参数key必填

upload_file

Upload a file through a file input element

输入参数uid必填filePath必填

close_page

Closes the page by its index; the last open page cannot be closed

输入参数pageId必填

list_pages

Get a list of pages open in the browser

无需输入参数。

navigate_page

Navigate the currently selected page to a URL, or back, forward or reload

输入参数urltypetimeoutignoreCache

new_page

Open a new tab and load a URL

输入参数url必填timeoutbackground

select_page

Select a page as the context for future tool calls

输入参数pageId必填bringToFront

wait_for

Wait until any of the provided texts appears on the selected page

输入参数text必填timeout

emulate

Emulates network, CPU, geolocation, user agent and colour scheme features on the selected page

输入参数userAgentcolorSchemegeolocationcpuThrottlingRatenetworkConditions

resize_page

Resizes the selected page's window so the page fits the given dimensions

输入参数width必填height必填

performance_analyze_insight

Provide more detailed information on a specific performance insight from a recorded trace

输入参数insightName必填insightSetId必填

performance_start_trace

Start a performance trace on the selected page

输入参数reloadautoStopfilePath

performance_stop_trace

Stop the active performance trace

输入参数filePath

get_network_request

Get a network request by its request id; without an id, the currently selected request in DevTools

输入参数reqid

list_network_requests

List all requests for the currently selected page since navigation

输入参数pageIdxpageSizeresourceTypesincludePreservedRequests

evaluate_script

Evaluate a JavaScript function inside the currently selected page and return its result

输入参数argsfunction必填

get_console_message

Get a console message by its id

输入参数msgid必填

list_console_messages

List all console messages for the currently selected page since navigation

输入参数typespageIdxpageSizeincludePreservedMessages

take_screenshot

Take a screenshot of the page or an element

输入参数uidformatqualityfilePathfullPage

take_snapshot

Take a text snapshot of the currently selected page based on the accessibility tree

输入参数verbosefilePath

版本历史

1
  1. v0.1.0最新Oct 31, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分