本文主要介绍函数服务（veFaaS）提供的 Browser MCP Server 浏览器原子化操作能力及其使用方法。

功能说明

veFaaS 提供 Browser-Use MCP Server 实现浏览器自动化能力。同时也支持提供各种浏览器原子化操作的 Browser MCP Server，满足用户对浏览器、网页元素、键盘、表单、标签页、截图、PDF 生成等的细粒度管理和操作需求。

本文主要介绍通过 Browser MCP Server 使用浏览器的方法（含本地或远程使用）。简单示例代码如下：

您可以按需在args字段下增加参数，可增加的参数说明如下：

参数	描述
--allowed-origins <origins>	允许浏览器请求的源列表，用分号（;）分隔。默认允许所有源。
--blocked-origins <origins>	阻止浏览器请求的源列表，用分号（;）分隔。阻止列表优先级高于允许列表。如果不配合允许列表使用，则除了阻止列表的源以外，其他源的请求均会被允许。
--block-service-workers	阻止 Service Worker。
--browser <browser>	要使用的浏览器或 Chrome 频道，取值： chrome：Google Chrome 浏览器 firefox：Mozilla Firefox 浏览器 webkit：WebKit 引擎（Safari 使用的引擎） msedge：Microsoft Edge 浏览器
--caps <caps>	要启用的额外功能列表。支持 vision 和 pdf 两种类型的功能列表，支持同时配置两种类型，用逗号（,）分隔。 --caps vision,pdf：同时启用视觉和 PDF 功能。 --caps vision：只启用视觉功能。 --caps pdf：只启用 PDF 功能。
--cdp-endpoint <endpoint>	要连接的客户数据平台（CDP）端点。
--config <path>	浏览器配置文件的路径。若不指定，则根据您安装的浏览器及其版本，在对应的默认配置文件路径下保存浏览器的配置信息。
--device <device>	要模拟的设备，例如：iPhone 15。
--executable-path <path>	浏览器可执行文件的路径。
--headless	配置该参数后，表示以无头模式运行浏览器。默认为有头模式，即不配置该参数。
--host <host>	服务器绑定的主机，默认为 localhost。如需绑定到所有网络接口，可配置为0.0.0.0。
--ignore-https-errors	忽略 HTTPS 错误。
--isolated	将浏览器配置文件保存在内存中，不保存到磁盘。
--image-responses <mode>	是否向客户端发送图像响应。取值： allow：（默认值）发送。 omit：不发送。
--no-sandbox	禁用沙箱。
--output-dir <path>	输出文件的目录路径。
--port <port>	Server-Sent Events（SSE）传输协议监听的端口。
--proxy-bypass <bypass>	要绕过代理的域名列表，用逗号（,）分隔，例如".com,chromium.org,.domain.com"。
--proxy-server <proxy>	指定代理服务器，例如"http://myproxy:3128"或"socks5://myproxy:8080"。
--save-trace	将会话的 Playwright 跟踪保存到输出文件的目录。
--storage-state <path>	隔离会话的存储状态文件路径。
--user-agent <ua string>	指定用户代理字符串。
--user-data-dir <path>	用户数据目录路径。如果未指定，将创建临时目录。
--viewport-size <size>	指定浏览器视口大小（像素），例如"1280, 720"。

使用方法

支持通过 stdio（standard input&output）方式使用 Browser MCP Server。

调用远程浏览器

{
"mcpServers": {
"vefaas-browser": {
"command": "npx",
"args": [
"@faas-mcp/browser@latest"
"--cdp-endpoint ws://sd1lqecn6rmou3g0tmej0.apigateway-cn-beijing.volceapi.com/v0.1/browsers/6f55a5c3-f495-4ea5-863e-55765abf0839/devtools/browser/3fc922d4-a668-412b-bdc3-46baa5018193?faasInstanceName=vefaas-ydej8hci-sq34afy9ap-d1rotceg68p2mudjluo0-sandbox"
]
},
]
}

调用本地浏览器

{
"mcpServers": {
"vefaas-browser": {
"command": "npx",
"args": [
"@faas-mcp/browser@latest"
]
}
}
}

支持的工具

互动类工具

导航类工具

资源类工具

工具类工具

标签页类工具

测试类工具

视觉模式工具

工具名称	描述	参数
browser_snapshot	捕获页面结构以进行自动化。	无。
browser_click	点击网页元素。	element：元素描述。 ref：元素引用。
browser_drag	执行拖放操作。	startElement：源元素描述。 startRef：源元素引用。 endElement：目标元素描述。 endRef：目标元素引用。
browser_hover	将鼠标悬停在元素上。	element：元素描述。 ref：元素引用。
browser_type	在字段中输入文本。	element：元素描述。 ref：元素引用。 text：要输入的文本。 submit：输入后提交。 slowly：逐字符输入。
browser_select_option	选择下拉菜单选项。	element：元素描述。 ref：元素引用。 values：要选择的选项。
browser_press_key	触发键盘按键。	key：按键名称或字符。
browser_wait_for	等待条件满足。	time：等待秒数。 text：等待出现的文本。 textGone：等待消失的文本。
browser_file_upload	上传文件。	paths：要上传的文件路径。
browser_handle_dialog	管理浏览器对话框。	accept：接受对话框。 promptText：提示文本。

工具名称	描述	参数
browser_navigate	打开指定的 URL。	url：目标URL
browser_navigate_back	返回上一页。	无。
browser_navigate_forward	前进到下一页。	无。

工具名称	描述	参数
browser_take_screenshot	捕获页面图像。	raw：无压缩图像。 filename：保存位置。 element：要捕获的元素。 ref：元素引用。
browser_pdf_save	将页面导出为 PDF。	filename：保存位置。
browser_network_requests	列出网络活动。	无。
browser_console_messages	显示控制台输出。	无。

工具名称	描述	参数
browser_install	设置浏览器环境。	无。
browser_close	退出当前页面。	无。
browser_resize	更改窗口尺寸。	width：窗口宽度。 height：窗口高度。

工具名称	描述	参数
browser_tab_list	显示打开的标签页。	无。
browser_tab_new	创建新标签页。	url：初始 URL。
browser_tab_select	切换活动标签页。	index：标签页位置。
browser_tab_close	删除标签页。	index：要关闭的标签页。

工具名称	描述	参数
browser_screen_capture	获取视觉快照。	无。
browser_screen_move_mouse	定位光标。	element：元素描述。 x：水平位置。 y：垂直位置。
browser_screen_click	在坐标处点击。	element：元素描述。 x：水平位置。 y：垂直位置。
browser_screen_drag	在点之间拖动。	element：元素描述。 startX/startY：起始位置。 endX/endY：结束位置。
browser_screen_type	在光标处输入文本。	text：要输入的文本。 submit：输入后按回车。

工具名称	描述	参数
browser_generate_playwright_test	创建自动化测试。	name：测试标识符。 description：测试目的。 steps：测试步骤。