Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WEB_BRIDGE_PROXYNoProxy address, e.g. 'http://proxy:3128'.
WEB_BRIDGE_CONFIGNoConfig file path.
WEB_BRIDGE_LOCALENoBrowser locale.
WEB_BRIDGE_BROWSERNoBrowser engine: chromium, firefox, or webkit.chromium
WEB_BRIDGE_SANDBOXNoBrowser sandbox: 'true' or 'false'. Set to 'false' when no sandbox in container.true
WEB_BRIDGE_HEADLESSNoHeadless mode: 'true' or 'false'.true
WEB_BRIDGE_TIMEZONENoBrowser timezone.
WEB_BRIDGE_VIEWPORTNoViewport size, e.g. '1440x900'.1280x720
WEB_BRIDGE_SETTLE_MSNoWait for async tasks to settle after an action (ms).500
WEB_BRIDGE_EXECUTABLENoCustom browser executable path.
WEB_BRIDGE_USER_AGENTNoCustom User-Agent.
WEB_BRIDGE_NAV_TIMEOUTNoNavigation timeout (ms, '0' = unlimited).60000
WEB_BRIDGE_PERMISSIONSNoPermissions granted to the context, comma-separated (e.g. 'geolocation,clipboard-read').
WEB_BRIDGE_TEST_ID_ATTRNoAttribute name used by the 'testid=' selector.data-testid
WEB_BRIDGE_STORAGE_STATENoSession restore file path (non-persistent mode only).
WEB_BRIDGE_USER_DATA_DIRNoUser data directory (persistent context; login state survives across sessions).
WEB_BRIDGE_ACTION_TIMEOUTNoPer-action timeout (ms, '0' = unlimited).10000
WEB_BRIDGE_IGNORE_HTTPS_ERRORSNoIgnore certificate errors (debug only): 'true' or 'false'.false

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
web_openA

在活动标签页中导航到指定 URL(无标签页时自动新建)。可选用更细的等待策略控制返回时机,适用于需要等待单页应用渲染完成或网络请求全部结束的场景。

权限说明:发起真实网络请求并渲染目标页面;请确保目标站点允许自动化访问。

web_backA

在活动标签页中后退到上一页历史记录。

权限说明:触发浏览器历史导航,可能重新加载页面。

web_forwardA

在活动标签页中前进到下一页历史记录。

权限说明:触发浏览器历史导航,可能重新加载页面。

web_refreshB

重新加载活动标签页。

权限说明:重新请求当前页面全部资源。

web_clickA

点击页面元素。目标可以是快照引用(推荐,ref 编号见最近一次 web_snapshot 输出)或选择器。支持鼠标按钮、双击与修饰键组合。

权限说明:向页面派发鼠标事件,可能触发跳转、表单提交或脚本副作用。

web_fillA

清空并填写输入框/文本域/可编辑区域。目标是快照引用或选择器。填写后触发 input 与 change 事件。

权限说明:修改页面表单数据,可能触发校验与提交逻辑。

web_typeA

向当前聚焦元素逐键输入文本,可模拟真实输入节奏。

权限说明:发送键盘事件到当前页面。

web_pressA

按下键盘按键(如 Enter、Escape、Tab、Control+a)。可先用 ref/selector 聚焦目标元素;未提供时作用于当前聚焦元素。

权限说明:发送键盘事件到当前页面。

web_selectA

在下拉列表(select)中选择一个或多个选项,可按 value 或按显示文本 label 选择。

权限说明:修改页面表单数据。

web_hoverA

把鼠标移动到元素上方(常用于触发悬停菜单与提示)。

权限说明:派发鼠标移动事件,可能触发 CSS 悬停效果。

web_scrollA

滚动页面或元素。direction=into_view 时将元素滚动到视野中央;提供 selector 时在元素内部滚动(或先将其带入视野);未提供 selector 时滚动整个页面。

权限说明:仅改变滚动位置,不产生网络请求。

web_snapshotA

生成当前页面的无障碍树快照:包含标题、URL 与带引用编号(ref)的元素树。交互元素(按钮/链接/输入框等)带 [编号] 前缀,后续 web_click / web_fill 等工具可用该编号定位。快照只包含结构化信息,不包含像素图像。

权限说明:只读操作,不产生网络请求;快照内容仅返回给调用方。

web_screenshotA

截取当前页面(视口或整页)或指定元素的图像,作为 MCP image 内容返回;可同时保存到本地文件。适合需要视觉确认的场合;日常结构化观察请优先使用 web_snapshot。

权限说明:只读页面内容;若提供 save_to 参数会向本地文件系统写入文件(路径由调用方指定)。

web_statusA

报告浏览器会话状态:是否运行、标签页列表(含 URL 与标题)、当前活动标签页。

权限说明:只读操作。

web_evaluateA

在页面上下文中执行 JavaScript 并返回结果。支持三种形态:函数表达式(function / async function / 箭头函数,以 arg 为参数调用并返回其返回值);表达式(返回求值结果);语句序列(let/var 多语句,返回最后一个表达式的值;含函数声明的语句序列按副作用执行,不返回结果,如需返回值请改用块箭头函数 + return)。返回值为 JSON 安全结构(undefined→null,循环引用→[Circular],NaN/Infinity→字符串,超长内容截断)。异步逻辑请使用 async 函数形态。

权限说明:高危操作:在页面内执行任意 JavaScript,可读取/修改页面数据、发起网络请求、获取 cookie 与登录态。仅在信任的页面上使用。

web_resizeA

调整浏览器视口尺寸(CSS 像素)。

权限说明:只改变渲染视口,不产生网络请求。

web_tab_newB

新建一个标签页,可带初始 URL;默认立即激活。

权限说明:新建浏览器标签页并可能发起网络请求。

web_tab_listA

列出全部标签页及其 URL 与标题。

权限说明:只读操作。

web_tab_switchA

切换活动标签页,后续动作作用到该标签页。

权限说明:只读操作。

web_tab_closeA

关闭标签页(默认关闭当前活动标签页)。关闭当前页后自动切换到剩余的第一个标签页。

权限说明:关闭浏览器标签页,未保存的表单数据将丢失。

web_waitA

按条件等待页面达到预期状态:页面加载完成(load)、网络空闲(networkidle)、元素出现/消失(selector)、URL 匹配(url)、或固定时长(sleep)。适合在页面渲染较慢或导航后需要同步时使用。

权限说明:只读操作(等待本身不产生网络请求)。

web_shutdownA

关闭浏览器实例并清理全部标签页与引用。之后任何操作都会自动重新启动浏览器。用于释放系统资源或清除会话痕迹。

权限说明:关闭浏览器进程,当前会话的未保存状态(登录态等)将丢失。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JohnXu22786/browser-automation'

If you have feedback or need assistance with the MCP directory API, please join our Discord server