本文主要介绍函数服务（veFaaS）提供的 Browser MCP Server 浏览器原子化操作能力及其使用方法。 ## 功能说明 veFaaS 提供 [Browser-Use MCP Server](https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_vefaas_browser_use) 实现浏览器自动化能力。同时也支持提供各种浏览器原子化操作的 Browser MCP Server，满足用户对浏览器、网页元素、键盘、表单、标签页、截图、PDF 生成等的细粒度管理和操作需求。本文主要介绍通过 Browser MCP Server 使用浏览器的方法（含本地或远程使用）。简单示例代码如下： ```JSON { "mcpServers": { "vefaas-browser": { "command": "npx", "args": [ "@faas-mcp/browser@latest" ] } } } ``` 您可以按需在`args`字段下增加参数，可增加的参数说明如下： |

参数

描述

| |---|---| |\-\-allowed\-origins |允许浏览器请求的源列表，用分号（`;`）分隔。默认允许所有源。 | |\-\-blocked\-origins |阻止浏览器请求的源列表，用分号（`;`）分隔。

* 阻止列表优先级高于允许列表。

* 如果不配合允许列表使用，则除了阻止列表的源以外，其他源的请求均会被允许。 | |\-\-block\-service\-workers |阻止 Service Worker。 | |\-\-browser |要使用的浏览器或 Chrome 频道，取值：

* **chrome**：Google Chrome 浏览器

* **firefox**：Mozilla Firefox 浏览器

* **webkit**：WebKit 引擎（Safari 使用的引擎）

* **msedge**：Microsoft Edge 浏览器 | |\-\-caps |要启用的额外功能列表。支持 **vision ** 和 ** pdf ** 两种类型的功能列表，支持同时配置两种类型，用逗号（`,`）分隔。

* `--caps vision,pdf`：同时启用视觉和 PDF 功能。

* `--caps vision`：只启用视觉功能。

* `--caps pdf`：只启用 PDF 功能。 | |\-\-cdp\-endpoint |要连接的客户数据平台（CDP）端点。 | |\-\-config |浏览器配置文件的路径。若不指定，则根据您安装的浏览器及其版本，在对应的默认配置文件路径下保存浏览器的配置信息。 | |\-\-device |要模拟的设备，例如：iPhone 15。 | |\-\-executable\-path |浏览器可执行文件的路径。 | |\-\-headless |配置该参数后，表示以无头模式运行浏览器。默认为有头模式，即不配置该参数。 | |\-\-host |服务器绑定的主机，默认为 **localhost**。如需绑定到所有网络接口，可配置为`0.0.0.0`。 | |\-\-ignore\-https\-errors |忽略 HTTPS 错误。 | |\-\-isolated |将浏览器配置文件保存在内存中，不保存到磁盘。 | |\-\-image\-responses |是否向客户端发送图像响应。取值：

* **allow**：（默认值）发送。

* **omit**：不发送。 | |\-\-no\-sandbox |禁用沙箱。 | |\-\-output\-dir |输出文件的目录路径。 | |\-\-port |Server\-Sent Events（SSE）传输协议监听的端口。 | |\-\-proxy\-bypass |要绕过代理的域名列表，用逗号（`,`）分隔，例如`".com,chromium.org,.domain.com"`。 | |\-\-proxy\-server |指定代理服务器，例如`"http://myproxy:3128"`或`"socks5://myproxy:8080"`。 | |\-\-save\-trace |将会话的 Playwright 跟踪保存到输出文件的目录。 | |\-\-storage\-state |隔离会话的存储状态文件路径。 | |\-\-user\-agent |指定用户代理字符串。 | |\-\-user\-data\-dir |用户数据目录路径。如果未指定，将创建临时目录。 | |\-\-viewport\-size |指定浏览器视口大小（像素），例如`"1280, 720"`。 | ## 使用方法支持通过 stdio（standard input&output）方式使用 Browser MCP Server。 * 调用远程浏览器 ```JSON { "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" ] }, ] } ``` * 调用本地浏览器 ```JSON { "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_generate_playwright_test |创建自动化测试。 |* name：测试标识符。

* description：测试目的。

* steps：测试步骤。 | 视觉模式工具 |工具名称 |描述 |参数 | |---|---|---| |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：输入后按回车。 |