mcpField
B
browserstage

browserstage

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

关于 browserstage

browserstage 将 CLI 与 stdio MCP 服务结合，通过页面无障碍快照定位元素并执行浏览器操作。它适用于需要以快照为依据自动化网页的 Agent；需注入 Playwright 兼容的执行器，软件本身不附带浏览器。

主要功能

  1. 01无障碍快照与元素查找
  2. 02导航、点击、悬停和拖放
  3. 03输入、表单填写与文件上传
  4. 04读取控制台消息和网络请求
  5. 05管理标签页及处理对话框

适用场景

  1. 01按页面快照定位并操作元素
  2. 02填写表单并上传文件
  3. 03检查浏览器控制台与网络请求

MCP 相关

提供 stdio MCP 服务，向 MCP 客户端开放浏览器导航、快照、交互、标签页管理及诊断工具。执行操作需要配置 Playwright 兼容的浏览器执行器。

配置

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

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

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

安装包
npm@reneturcios/browserstage0.1.0
ocighcr.io/cloudcorprecords/browserstage:0.1.0

工具

24

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

参数类型必填说明
urlstring是要导航到的页面 URL

详细介绍

browserstage

由快照驱动的浏览器自动化工具，同时提供 CLI 和 stdio MCP 服务。 导航、捕获页面的无障碍快照，然后根据快照中的引用对元素执行操作： 点击、悬停、拖动、放下、输入、填写整个表单、选择选项、 按键、上传文件和处理对话框。控制台消息和网络请求也可通过工具读取，还可以列出、 创建、关闭和选择标签页。

浏览器位于可注入的执行器接口之后 （src/types.ts 中的 StageBrowser）。此软件包不捆绑也不下载浏览器： 未配置执行器时，浏览器命令会失败，并显示清晰的“Browser unavailable”错误。部署时注入 兼容 Playwright 的执行器，以驱动真实浏览器。 browser_run_code_unsafe 工具会针对页面运行任意代码，这是原设计中的功能，因此此处保留该名称和警告： 仅在你愿意亲自运行任意代码的环境中启用它。

安装

npx -y @reneturcios/browserstage mcp

CLI

browserstage mcp
browserstage navigate <url>
browserstage snapshot
browserstage press <key>
browserstage resize <width> <height>
browserstage --version

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

MCP 工具

24 个核心工具：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 客户端配置：

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

Docker

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

开发

npm install
npm run build
npm test

MIT 许可证。

评论

支持 Markdown

第一次接触 MCP？

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

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