mcp/playwright
Playwright MCP服务器是基于微软Playwright自动化测试工具的管理控制平台，主要用于跨浏览器（如Chrome、Firefox、WebKit等）的端到端测试任务调度与执行，支持用户交互模拟、多环境部署管理、测试资源分配、CI/CD流程集成及测试结果分析，能有效提升Web应用测试效率，保障应用在不同浏览器和设备上的兼容性与稳定性，助力开发团队实现高质量软件交付。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Playwright MCP Server
基于Playwright的模型上下文协议（MCP）服务器。
[什么是MCP服务器？]
基本特性
| 属性 | 详情 |
|---|---|
| Docker镜像 | [mcp/playwright] |
| 作者 | [microsoft] |
| 代码仓库 | [] |
| Dockerfile | [] |
| 镜像构建方 | Docker Inc. |
| Docker Scout健康评分 | ![Docker Scout Health Score] |
| 验证签名 | `COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/playwright --key [] |
| 许可证 | Apache License 2.0 |
可用工具（21个）
| 服务器提供的工具 | 简要说明 |
|---|---|
browser_click | 点击页面元素 |
browser_close | 关闭浏览器页面 |
browser_console_messages | 获取控制台消息 |
browser_drag | 鼠标拖拽操作 |
browser_evaluate | 执行JavaScript代码 |
browser_file_upload | 上传文件 |
browser_fill_form | 填写表单字段 |
browser_handle_dialog | 处理弹窗 |
browser_hover | 鼠标悬停元素 |
browser_install | 安装配置中指定的浏览器 |
browser_navigate | 导航至URL |
browser_navigate_back | 返回上一页 |
browser_network_requests | 列出网络请求 |
browser_press_key | 模拟按键操作 |
browser_resize | 调整浏览器窗口大小 |
browser_select_option | 选择下拉框选项 |
browser_snapshot | 捕获页面可访问性快照 |
browser_tabs | 管理标签页（列出/创建/关闭/切换） |
browser_take_screenshot | 截取页面截图 |
browser_type | 在元素中输入文本 |
browser_wait_for | 等待文本出现/消失或指定时长 |
工具详情
工具：browser_click
在网页上执行点击操作
| 参数 | 类型 | 说明 |
|---|---|---|
element | string | 用于获取交互权限的元素描述（人类可读） |
ref | string | 页面快照中的目标元素精确引用 |
button | string 可选 | 点击的鼠标按键，默认左键 |
doubleClick | boolean 可选 | 是否执行双击（默认单击） |
modifiers | array 可选 | 需按下的修饰键 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_close
关闭当前页面
工具：browser_console_messages
获取所有控制台消息
| 参数 | 类型 | 说明 |
|---|---|---|
onlyErrors | boolean 可选 | 是否仅返回错误消息 |
此工具为只读，不修改环境。
此工具与外部实体交互。
工具：browser_drag
在两个元素间执行拖放操作
| 参数 | 类型 | 说明 |
|---|---|---|
endElement | string | 目标元素的人类可读描述（用于获取交互权限） |
endRef | string | 目标元素的精确引用（来自页面快照） |
startElement | string | 源元素的人类可读描述（用于获取交互权限） |
startRef | string | 源元素的精确引用（来自页面快照） |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_evaluate
在页面或元素上执行JavaScript表达式
| 参数 | 类型 | 说明 |
|---|---|---|
function | string | 执行的代码，格式为 () => { /* 代码 */ }；若提供元素，格式为 (element) => { /* 代码 */ } |
element | string 可选 | 用于获取交互权限的元素描述（人类可读） |
ref | string 可选 | 页面快照中的目标元素精确引用 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_file_upload
上传一个或多个文件
| 参数 | 类型 | 说明 |
|---|---|---|
paths | array 可选 | 待上传文件的绝对路径（支持单个或多个文件）；若省略则取消文件选择 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_fill_form
填写多个表单字段
| 参数 | 类型 | 说明 |
|---|---|---|
fields | array | 需填写的字段列表 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_handle_dialog
处理弹窗
| 参数 | 类型 | 说明 |
|---|---|---|
accept | boolean | 是否接受弹窗 |
promptText | string 可选 | 若为提示框（prompt），需输入的文本 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_hover
鼠标悬停在页面元素上
| 参数 | 类型 | 说明 |
|---|---|---|
element | string | 用于获取交互权限的元素描述（人类可读） |
ref | string | 页面快照中的目标元素精确引用 |
此工具为只读，不修改环境。
此工具与外部实体交互。
工具：browser_install
安装配置中指定的浏览器。若遇到浏览器未安装的错误，可调用此工具。
工具：browser_navigate
导航至指定URL
| 参数 | 类型 | 说明 |
|---|---|---|
url | string | 目标URL |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_navigate_back
返回上一页
工具：browser_network_requests
返回页面加载后的所有网络请求
工具：browser_press_key
模拟键盘按键
| 参数 | 类型 | 说明 |
|---|---|---|
key | string | 按键名称或字符，如 ArrowLeft（左箭头）或 a |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_resize
调整浏览器窗口大小
| 参数 | 类型 | 说明 |
|---|---|---|
height | number | 窗口高度 |
width | number | 窗口宽度 |
此工具为只读，不修改环境。
此工具与外部实体交互。
工具：browser_select_option
选择下拉框中的选项
| 参数 | 类型 | 说明 |
|---|---|---|
element | string | 用于获取交互权限的元素描述（人类可读） |
ref | string | 页面快照中的目标元素精确引用 |
values | array | 待选择的选项值（单个或多个） |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_snapshot
捕获当前页面的可访问性快照（比截图更适用于后续操作）
工具：browser_tabs
列出、创建、关闭或切换浏览器标签页
| 参数 | 类型 | 说明 |
|---|---|---|
action | string | 操作类型（如列出/创建/关闭/切换） |
index | number 可选 | 标签页索引（用于关闭/切换），关闭时若省略则关闭当前标签页 |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_take_screenshot
截取当前页面截图（无法基于截图执行后续操作，需用 browser_snapshot）
| 参数 | 类型 | 说明 |
|---|---|---|
element | string 可选 | 截图元素的人类可读描述（需与 ref 同时提供，否则截取视口） |
filename | string 可选 | 截图保存文件名，默认 `page-{timestamp}.{png |
fullPage | boolean 可选 | 是否截取整页（滚动区域），不可与元素截图同时使用 |
ref | string 可选 | 页面快照中的目标元素精确引用（需与 element 同时提供） |
type | string 可选 | 截图格式，默认 png |
此工具为只读，不修改环境。
此工具与外部实体交互。
工具：browser_type
在可编辑元素中输入文本
| 参数 | 类型 | 说明 |
|---|---|---|
element | string | 用于获取交互权限的元素描述（人类可读） |
ref | string | 页面快照中的目标元素精确引用 |
text | string | 输入的文本内容 |
slowly | boolean 可选 | 是否逐字符输入（默认一次性填入，逐字符输入可触发页面按键事件） |
submit | boolean 可选 | 输入后是否提交（按Enter键） |
此工具可能执行破坏性更新。
此工具与外部实体交互。
工具：browser_wait_for
等待文本出现/消失或指定时长
| 参数 | 类型 | 说明 |
|---|---|---|
text | string 可选 | 等待出现的文本 |
textGone | string 可选 | 等待消失的文本 |
time | number 可选 | 等待时长（秒） |
此工具为只读，不修改环境。
此工具与外部实体交互。
使用此MCP服务器
配置示例如下：
json{ "mcpServers": { "playwright": { "command": "docker", "args": [ "run", "-i", "--rm", "mcp/playwright" ] } } }
[为什么使用Docker运行MCP服务器更安全？]
更多相关 Docker 镜像与资源
以下是 mcp/playwright 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- jacoblincool/playwright Docker 镜像说明（Playwright 社区打包（jacoblincool），适合 E2E 自动化测试）
- platformos/playwright Docker 镜像说明（PlatformOS Playwright 测试镜像，适合 Web 应用 E2E 测试）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull mcp/playwright:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"