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 分