Headlessstage

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

Browser automation: navigate, click, fill, screenshot and evaluate in a headless browser.

已验证STDIO仅桌面浏览器自动化

概览

AI 生成的概览

本地 stdio MCP 服务器，为助手提供无头浏览器工具：导航、点击、悬停、填写、选择、截图和执行 JavaScript。

可以做什么
  • 让浏览器导航到任意网址
  • 点击、悬停、填写和选择页面元素与表单字段
  • 截取整页或指定元素的截图
  • 在页面控制台执行 JavaScript
适用场景
适合需要助手直接操作网页的场景：填写表单、走完一段点击流程、查看页面渲染结果或截图。注意该包本身不含浏览器，只有在注入了 Puppeteer 兼容执行器时才能工作。
运行要求
通过 npx 或 Docker 镜像作为本地进程运行；未声明任何认证、环境变量或请求头。需要部署方注入 Puppeteer 兼容的浏览器执行器，因为该包不捆绑也不下载浏览器。
安装前请注意
未注入执行器时，浏览器命令会以“Browser unavailable”错误失败。evaluate 工具会在页面中执行任意 JavaScript，click、fill 和 select 会改变页面状态。削弱浏览器安全的启动选项（如 --no-sandbox、--disable-web-security）会被拒绝，除非调用显式传入 allowDangerous: true。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

headlessstage

Browser automation through a headless browser page, as a CLI and a stdio MCP server in one bin. Navigate to a URL, click, hover, fill and select form elements, take named screenshots and evaluate JavaScript in the page.

The browser itself sits behind an injectable executor interface (BrowserExecutor 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 Puppeteer-compatible executor to drive a real browser. Launch options that weaken browser security (--no-sandbox, --disable-web-security, --allow-insecure-localhost) are rejected unless a call explicitly passes allowDangerous: true.

Install

bash
npx -y @reneturcios/headlessstage mcp

CLI

bash
headlessstage mcp                     # stdio MCP serverheadlessstage navigate <url>headlessstage screenshot <name> [selector]headlessstage click <selector>headlessstage fill <selector> <value>headlessstage evaluate <script>headlessstage --version

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

MCP tools

ToolPurpose
puppeteer_navigateNavigate to any URL in the browser
puppeteer_screenshotCapture screenshots of the entire page or specific elements
puppeteer_clickClick elements on the page
puppeteer_hoverHover elements on the page
puppeteer_fillFill out input fields
puppeteer_selectSelect an element with a SELECT tag
puppeteer_evaluateExecute JavaScript in the browser console

MCP client config:

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

Docker

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

Development

bash
npm installnpm run buildnpm test

MIT license.

来源：README.md，提交 df67cb3

工具

7

puppeteer_navigate

Navigate to any URL in the browser

输入参数url必填launchOptionsallowDangerous

puppeteer_screenshot

Capture screenshots of the entire page or specific elements

输入参数name必填widthheightencodedselector

puppeteer_click

Click elements on the page

输入参数selector必填

puppeteer_hover

Hover elements on the page

输入参数selector必填

puppeteer_fill

Fill out input fields

输入参数value必填selector必填

puppeteer_select

Select an element with a SELECT tag

输入参数value必填selector必填

puppeteer_evaluate

Execute JavaScript in the browser console

输入参数script必填

版本历史

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

评分

已满足适用检查项的 90%

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

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

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

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