mcp/mcp-playwrightPlaywright模型上下文协议(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",

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务