brawsr

Name: brawsr
Author: brawsr

本地服务

docs.brawsr.io浏览器自动化011 周前更新

代码仓库访问官网

关于 brawsr

brawsr 是用于管理经过身份验证的 brawsr 浏览器会话的本地 stdio MCP 服务。它通过官方 SDK 提供会话生命周期、检查点、回退、分叉和谱系操作。

主要功能

01创建、列出、标记和关闭会话
02创建和查看检查点
03查找可回退的检查点
04回退或分叉浏览器会话
05查看会话活动与谱系
06跟踪异步操作

适用场景

01通过 MCP 客户端管理浏览器会话
02在更改前保存浏览器状态
03恢复或分叉会话以探索不同方案

MCP 相关

MCP 客户端通过 stdio 在本地启动服务，并提供 brawsr API 密钥。其工具用于管理会话、检查点、回退、分叉、谱系和操作。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "brawsr-brawsr": {
      "command": "npx",
      "args": [
        "-y",
        "@brawsr/mcp-server"
      ],
      "env": {
        "BRAWSR_API_KEY": "<BRAWSR_API_KEY>",
        "BRAWSR_BASE_URL": "<BRAWSR_BASE_URL>",
        "BRAWSR_MCP_TIMEOUT_MS": "<BRAWSR_MCP_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y @brawsr/mcp-server

需要配置的环境变量

BRAWSR_API_KEY密钥API key for the brawsr project used by this MCP server.

BRAWSR_BASE_URLOptional explicit API endpoint override for local development or another deployment.

BRAWSR_MCP_TIMEOUT_MSOptional default lifecycle wait in milliseconds, from 1 through 300000.

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

安装包

npm@brawsr/mcp-server0.2.0stdio

工具

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

参数	类型	必填	说明
ttl_seconds	integer	否
display_label	string	否

详细介绍

brawsr MCP 服务

用于 brawsr 浏览器会话、检查点、回退和分叉的本地认证 MCP 桥接服务。它使用官方打包的 @brawsr/sdk；不会重复定义 API 模型、轮询编排流程或浏览器/CDP 行为。

v0.2 传输方式为本地 stdio，需要 Node.js 22+。

安装和配置

MCP 客户端会在本地启动该服务。在客户端配置中固定软件包版本，以免 MCP 客户端重启时悄然选择更新版本：

{
  "mcpServers": {
    "brawsr": {
      "command": "npx",
      "args": ["-y", "@brawsr/[email protected]"],
      "env": {
        "BRAWSR_API_KEY": "your-brawsr-api-key"
      }
    }
  }
}

npm 软件包包含官方 @brawsr/sdk；无需再安装第二个软件包。BRAWSR_API_KEY 是唯一必需的环境变量。生产端点 https://api.brawsr.io 已内置。

用于本地开发或其他部署时，可通过 BRAWSR_BASE_URL 显式覆盖该端点。BRAWSR_MCP_TIMEOUT_MS 可选用于更改默认的 30 秒有界操作等待时间，接受 1 到 300000 之间的整数。

API 密钥绝不会作为工具参数或结果返回。标准输出专用于 MCP 协议消息。经脱敏的生命周期诊断信息会写入标准错误。直接通过 shell 启动时使用相同的可执行文件：

BRAWSR_API_KEY=... npx -y @brawsr/[email protected]

工具

brawsr_create_session、brawsr_list_sessions、brawsr_get_session、 brawsr_update_session_label、brawsr_close_session
brawsr_close_sessions
brawsr_create_checkpoint、brawsr_get_checkpoint、 brawsr_list_checkpoints、brawsr_delete_checkpoint
brawsr_list_rewindable_checkpoints、brawsr_list_session_activity、 brawsr_get_session_lineage
brawsr_rewind、brawsr_fork
brawsr_get_operation、brawsr_wait_operation

创建会话时可选提供 display_label。通过一次 brawsr_update_session_label 调用即可更改或清除此标签。会话列表按最新优先排序，数量有限，可能包含保留的已关闭或已过期会话。brawsr_get_session 仅在会话可连接时包含 CDP URL。

brawsr_list_checkpoints 返回捕获历史记录：为供审计和仪表板查看，其中可能包含已删除的捕获。选择有效的回退或分叉目标时，请使用 brawsr_list_rewindable_checkpoints。血缘信息会返回一个会话、其可选的父级分叉边，以及一页数量有限的直接子会话；调用方可通过子会话 ID 浏览嵌套分叉树。分页游标是不透明的，可原样传回。

检查点、回退和分叉均通过一次高级工具调用完成。打包的 SDK 会隐藏常规的 202 轮询。回退会在结果可供 CDP 使用时立即返回；操作可能会在后台完成有界的恢复后续工作。超时只会停止本地等待，并返回操作/幂等性恢复字段；服务端工作会继续。

分叉产生的子会话是彼此独立的同级会话，不会隐式判定胜负。不会合并浏览器状态，也不会自动清理同级会话。回退会恢复浏览器/客户端状态，不会恢复远程网站上的副作用，并会使旧的 CDP/浏览器句柄失效。长时间运行的 WSS/SSE/WebRTC 流可能需要在应用层重新连接。

CDP URL 是敏感结构化输出。MCP 服务绝不会返回 Authorization 标头。请使用常规 SDK 或受支持的框架进行连接；MCP 服务不会代理 CDP。

远程 Streamable HTTP、OAuth、托管式多租户、旧版 HTTP+SSE，以及可恢复 MCP 会话均不在本地 v0.2 stdio 范围内，暂不支持。

开发

npm ci
npm run verify

发布归档使用固定的 Node 24 和 npm 11.5.1 工具链进行可重现构建。CI 也会在 Node 22 和 Node 24 上测试该服务及其真实 MCP 客户端边界。npm 托管可执行软件包；官方 MCP Registry 托管 io.github.brawsr/brawsr 的发现元数据。

支持 Markdown

登录后评论