Browserstage

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Automate a browser with accessibility snapshots: navigate, click, type, fill and wait.

已驗證STDIO僅桌面瀏覽器自動化開發者工具

概覽

AI 產生的概覽

以無障礙快照為基礎的瀏覽器自動化 MCP 伺服器，讓助理導覽網頁、依快照參照操作元素，並檢視主控台與網路請求。

可以做什麼
  • 導覽頁面、返回上一頁、調整視窗大小、管理分頁並關閉瀏覽器
  • 擷取無障礙快照、在快照中以文字或正規表示式搜尋、拍攝螢幕截圖
  • 操作元素：點擊、懸停、拖放、選擇下拉選項、輸入文字、按鍵、填寫表單、上傳檔案、處理對話框
  • 等待文字出現或消失、等待指定時間，並在頁面上求值 JavaScript 或執行 Playwright 程式碼片段
  • 讀取主控台訊息，列出並檢視網路請求詳情
適用情境
適合需要助理操作真實瀏覽器的情境，例如填寫表單、走完某個網頁流程、檢查頁面呈現結果，或排查主控台與網路行為。較適合本機桌面環境，而非無頭伺服器部署。
執行需求
透過 npx 或 Docker 映像以 stdio 在本機執行。此套件不內建也不下載瀏覽器；未注入 Playwright 相容執行器時，瀏覽器指令會以「Browser unavailable」錯誤失敗。未宣告驗證、環境變數或標頭。
安裝前請注意
browser_run_code_unsafe 工具會在頁面上執行任意程式碼，只應在你本來就允許執行任意程式碼的環境中啟用。助理可以輸入、上傳檔案、送出表單並點擊真實網站，可能變更或傳送資料。主控台與網路工具會暴露頁面流量，包括請求中可見的憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Browserstage，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

browserstage

Snapshot-driven browser automation as a CLI and a stdio MCP server in one bin. Navigate, capture an accessibility snapshot of the page, then act on elements by the references in that snapshot: click, hover, drag, drop, type, fill whole forms, select options, press keys, upload files and handle dialogs. Console messages and network requests are readable tools, and tabs can be listed, created, closed and selected.

The browser sits behind an injectable executor interface (StageBrowser 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 Playwright-compatible executor to drive a real browser. The browser_run_code_unsafe tool runs arbitrary code against the page in the original design and keeps that name and its warning here: only enable it where you would run arbitrary code yourself.

Install

bash
npx -y @reneturcios/browserstage mcp

CLI

bash
browserstage mcpbrowserstage navigate <url>browserstage snapshotbrowserstage press <key>browserstage resize <width> <height>browserstage --version

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

MCP tools

24 core tools: browser_navigate, browser_navigate_back, browser_snapshot, browser_find, browser_click, browser_hover, browser_drag, browser_drop, browser_select_option, browser_type, browser_press_key, browser_fill_form, browser_take_screenshot, browser_run_code_unsafe, browser_evaluate, browser_wait_for, browser_handle_dialog, browser_file_upload, browser_console_messages, browser_network_requests, browser_network_request, browser_tabs, browser_close, browser_resize.

MCP client config:

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

Docker

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

Development

bash
npm installnpm run buildnpm test

MIT license.

來源：README.md，提交 ac97629

工具

24

browser_navigate

Navigate to a URL

輸入參數url必填

browser_navigate_back

Go back to the previous page in the browser history

無需輸入參數。

browser_snapshot

Capture accessibility snapshot of the current page

輸入參數depthtargetfilename

browser_find

Search the accessibility snapshot for text or a regular expression

輸入參數textregex

browser_click

Perform click on a web page

輸入參數buttontarget必填element必填doubleClick

browser_hover

Hover over an element on the page

輸入參數target必填element必填

browser_drag

Perform drag and drop between two elements

輸入參數endTarget必填endElement必填startTarget必填startElement必填

browser_drop

Drop files or data onto an element on the page

輸入參數pathstarget必填element必填

browser_select_option

Select an option in a dropdown

輸入參數target必填values必填

browser_type

Type text into an editable element

輸入參數text必填slowlysubmittarget必填element必填

browser_press_key

Press a key on the keyboard

輸入參數key必填

browser_fill_form

Fill multiple form fields

輸入參數fields必填

browser_take_screenshot

Take a screenshot of the current page

輸入參數typetargetfilenamefullPage

browser_run_code_unsafe

Run a Playwright code snippet against the current page (unsafe: arbitrary code execution)

輸入參數code必填

browser_evaluate

Evaluate JavaScript expression on the page or on an element

輸入參數targetelementfunction必填

browser_wait_for

Wait for text to appear or disappear, or for a specified time to pass

輸入參數texttimetextGone

browser_handle_dialog

Handle a browser dialog

輸入參數accept必填promptText

browser_file_upload

Upload one or multiple files

輸入參數paths

browser_console_messages

Returns all console messages

輸入參數alllevelfilename

browser_network_requests

Returns a numbered list of network requests since loading the page

輸入參數staticfilename

browser_network_request

Returns the full details of a single network request

輸入參數index必填filename

browser_tabs

List, create, close, or select a browser tab

輸入參數urlindexaction必填

browser_close

Close the current page and the browser

無需輸入參數。

browser_resize

Resize the browser window

輸入參數width必填height必填

版本歷史

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

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分