Playwright模型上下文协议(MCP)服务器 - 用于在Claude Desktop、Cline、Cursor IDE等环境中自动化浏览器和API的工具 🔌。
什么是MCP服务器?
| 属性 | 详情 |
|---|---|
| Docker镜像 | mcp/mcp-playwright |
| 作者 | executeautomation |
| 仓库 | [***] |
| 属性 | 详情 |
|---|---|
| Dockerfile | [***] |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout健康评分 |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/mcp-playwright --key [***] |
| 许可证 | MIT许可证 |
| 工具提供的功能 | 简短描述 |
|---|---|
clear_codegen_session | 清除代码生成会话而不生成测试 |
end_codegen_session | 结束代码生成会话并生成测试文件 |
get_codegen_session | 获取代码生成会话信息 |
playwright_assert_response | 等待并验证先前发起的HTTP响应等待操作 |
playwright_click | 点击页面上的元素 |
playwright_click_and_switch_tab | 点击链接并切换到新打开的标签页 |
playwright_close | 关闭浏览器并释放所有资源 |
playwright_console_logs | 检索浏览器控制台日志(带过滤选项) |
playwright_custom_user_agent | 为浏览器设置自定义User Agent |
playwright_delete | 执行HTTP DELETE请求 |
playwright_drag | 将元素拖到目标位置 |
playwright_evaluate | 在浏览器控制台执行JavaScript |
playwright_expect_response | 让Playwright开始等待HTTP响应 |
playwright_fill | 填写输入字段 |
playwright_get | 执行HTTP GET请求 |
playwright_get_visible_html | 获取当前页面的HTML内容 |
playwright_get_visible_text | 获取当前页面的可见文本内容 |
playwright_go_back | 浏览器历史后退 |
playwright_go_forward | 浏览器历史前进 |
playwright_hover | 悬停页面上的元素 |
playwright_iframe_click | 点击iframe中的元素 |
playwright_iframe_fill | 填写iframe中的元素 |
playwright_navigate | 导航到URL |
playwright_patch | 执行HTTP PATCH请求 |
playwright_post | 执行HTTP POST请求 |
playwright_press_key | 按下键盘按键 |
playwright_put | 执行HTTP PUT请求 |
playwright_save_as_pdf | 将当前页面保存为PDF文件 |
playwright_screenshot | 截取当前页面或特定元素的截图 |
playwright_select | 选择页面上带Select标签的元素 |
playwright_upload_file | 上传文件到input[type='file']元素 |
start_codegen_session | 开始新的代码生成会话以记录Playwright操作 |
clear_codegen_session清除代码生成会话而不生成测试
| 参数 | 类型 | 描述 |
|---|---|---|
sessionId | string | 要清除的会话ID |
end_codegen_session结束代码生成会话并生成测试文件
| 参数 | 类型 | 描述 |
|---|---|---|
sessionId | string | 要结束的会话ID |
get_codegen_session获取代码生成会话信息
| 参数 | 类型 | 描述 |
|---|---|---|
sessionId | string | 要检索的会话ID |
playwright_assert_response等待并验证先前发起的HTTP响应等待操作。
| 参数 | 类型 | 描述 |
|---|---|---|
id | string | 使用playwright_expect_response初始预期的HTTP响应标识符 |
value | string 可选 | 预期在HTTP响应体中的数据。如果提供,响应体中未找到此值则断言失败 |
playwright_click点击页面上的元素
| 参数 | 类型 | 描述 |
|---|---|---|
selector | string | 要点击元素的CSS选择器 |
playwright_click_and_switch_tab点击链接并切换到新打开的标签页
| 参数 | 类型 | 描述 |
|---|---|---|
selector | string | 要点击链接的CSS选择器 |
playwright_close关闭浏览器并释放所有资源
playwright_console_logs检索浏览器控制台日志(带过滤选项)
| 参数 | 类型 | 描述 |
|---|---|---|
clear | boolean 可选 | 检索后是否清除日志(默认:false) |
limit | number 可选 | 返回日志的最大数量 |
search | string 可选 | 日志中要搜索的文本(支持含方括号的文本) |
type | string 可选 | 要检索的日志类型(all、error、warning、log、info、debug、exception) |
playwright_custom_user_agent为浏览器设置自定义User Agent
| 参数 | 类型 | 描述 |
|---|---|---|
userAgent | string | Playwright浏览器实例的自定义User Agent |
playwright_delete执行HTTP DELETE请求
| 参数 | 类型 | 描述 |
|---|---|---|
url | string | 执行DELETE操作的URL |
playwright_drag将元素拖到目标位置
| 参数 | 类型 | 描述 |
|---|---|---|
sourceSelector | string | 要拖动元素的CSS选择器 |
targetSelector | string | 目标位置的CSS选择器 |
playwright_evaluate在浏览器控制台执行JavaScript
| 参数 | 类型 | 描述 |
|---|---|---|
script | string | 要执行的JavaScript代码 |
playwright_expect_response让Playwright开始等待HTTP响应。此工具启动等待操作但不等待其完成。
| 参数 | 类型 | 描述 |
|---|---|---|
id | string | 用于稍后通过playwright_assert_response检索此响应的唯一任意标识符 |
url | string | 要匹配响应的URL模式 |
playwright_fill填写输入字段
| 参数 | 类型 | 描述 |
|---|---|---|
selector | string | 输入字段的CSS选择器 |
value | string | 要填写的值 |
playwright_get执行HTTP GET请求
| 参数 | 类型 | 描述 |
|---|---|---|
url | string | 执行GET操作的URL |
playwright_get_visible_html获取当前页面的HTML内容。默认情况下,所有
| 参数 | 类型 | 描述 |
|---|---|---|
cleanHtml | boolean 可选 | 执行全面的HTML清理(默认:false) |
maxLength | number 可选 | 返回的最大字符数(默认:20000) |
minify | boolean 可选 | 压缩HTML输出(默认:false) |
removeComments | boolean 可选 | 移除所有HTML注释(默认:false) |
removeMeta | boolean 可选 | 移除所有meta标签(默认:false) |
removeScripts | boolean 可选 | 移除所有script标签(默认:true) |
removeStyles | boolean 可选 | 移除所有style标签(默认:false) |
selector | string 可选 | 限制HTML到特定容器的CSS选择器 |
playwright_get_visible_text获取当前页面的可见文本内容
playwright_go_back浏览器历史后退
playwright_go_forward浏览器历史前进
playwright_hover悬停页面上的元素
| 参数 | 类型 | 描述 |
|---|---|---|
selector | string | 要悬停元素的CSS选择器 |
playwright_iframe_click点击iframe中的元素
| 参数 | 类型 | 描述 |
|---|---|---|
iframeSelector | string | 包含要点击元素的iframe的CSS选择器 |
selector | string | 要点击元素的CSS选择器 |
playwright_iframe_fill填写iframe中的元素
| 参数 | 类型 | 描述 |
|---|---|---|
iframeSelector | string | 包含要填写元素的iframe的CSS选择器 |
selector | string | 要填写元素的CSS选择器 |
value | string | 要填写的值 |
playwright_navigate导航到URL
| 参数 | 类型 | 描述 |
|---|---|---|
url | string | 要导航到的网站URL |
browserType | string 可选 | 使用的浏览器类型(chromium、firefox、webkit),默认:chromium |
headless | boolean 可选 | 以无头模式运行浏览器(默认:false) |
height | number 可选 | 视口高度(像素,默认:720) |
timeout | number 可选 | 导航超时时间(毫秒) |
waitUntil | string 可选 | 导航等待条件 |
width | number 可选 | 视口宽度(像素,默认:1280) |
playwright_patch执行HTTP PATCH请求
| 参数 | 类型 | 描述 |
|---|---|---|
url | string | 执行PATCH操作的URL |
value | string | 要在请求体中发送的PATCH数据 |
playwright_post执行HTTP POST请求
| 参数 | 类型 | 描述 |
|---|---|---|
url | string | 执行POST操作的URL |
value | string | 要在请求体中发送的POST数据 |
headers | object 可选 | 请求中包含的额外头信息 |
token | string 可选 | 用于授权的Bearer令牌 |
playwright_press_key按下键盘按键
| 参数 | 类型 | 描述 |
|---|---|---|
key | string | 要按下的键(例如:'Enter'、'ArrowDown'、'a') |
selector | string 可选 | 按下键前要聚焦的可选CSS选择器 |
playwright_put执行HTTP PUT请求
| 参数 | 类型 | 描述 |
|---|---|---|
url | string | 执行PUT操作的URL |
value | string | 要在请求体中发送的PUT数据 |
playwright_save_as_pdf将当前页面保存为PDF文件
| 参数 | 类型 | 描述 |
|---|---|---|
outputPath | string | PDF保存的目录路径 |
filename | string 可选 | PDF文件名(默认:page.pdf) |
format | string 可选 | 页面格式(例如:'A4'、'Letter') |
margin | object 可选 | 页面边距 |
printBackground | boolean 可选 | 是否打印背景图形 |
playwright_screenshot截取当前页面或特定元素的截图
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 截图名称 |
downloadsDir | string 可选 | 自定义下载目录路径(默认:用户的Downloads文件夹) |
fullPage | boolean 可选 | 是否截取整个页面(默认:false) |
height | number 可选 | 高度(像素,默认:600) |
savePng | boolean 可选 | 是否保存为PNG文件(默认:false) |
selector | string 可选 | 要截图元素的CSS选择器 |
storeBase64 | boolean 可选 | 是否以base64格式存储截图(默认:true) |
width | number 可选 | 宽度(像素,默认:800) |
playwright_select选择页面上带Select标签的元素
| 参数 | 类型 | 描述 |
|---|---|---|
selector | string | 要选择元素的CSS选择器 |
value | string | 要选择的值 |
playwright_upload_file上传文件到input[type='file']元素
| 参数 | 类型 | 描述 |
|---|---|---|
filePath | string | 要上传文件的绝对路径 |
selector | string | 文件输入元素的CSS选择器 |
start_codegen_session开始新的代码生成会话以记录Playwright操作
| 参数 | 类型 | 描述 |
|---|---|---|
options | object | 代码生成选项 |
json{ "mcpServers": { "playwright-mcp-server": { "command": "docker", "args": [ "run",
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429