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、地理位置、使用者代理與配色配置，調整視窗尺寸，並在頁面中執行 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 分