Playwright MCP

该项目利用Playwright进行自动化浏览器测试，并与Cloudflare Workers、Browser Rendering和@cloudflare/playwright集成部署，支持通过AI助手进行网页交互操作。

浏览器自动化开发者工具 #自动化测试 #浏览器交互 #AI助手 #云部署本地 .TypeScript

评分 : 2.5分

下载量 : 49

更新时间 : 2025-04-28

什么是Cloudflare Playwright MCP？

Cloudflare Playwright MCP是一个基于Playwright的自动化浏览器操作工具，支持开发者通过模型生成指令来完成网页交互任务。它能够帮助用户实现如截图、点击、输入等操作，广泛应用于测试、AI协作等领域。

如何使用Cloudflare Playwright MCP？

只需部署服务器并配置模型连接即可开始使用。通过简单的指令触发工具执行操作，例如导航到特定页面或进行截图。

适用场景

适合需要频繁进行网页交互或自动化测试的场景，例如网站监控、数据抓取、智能客服等。

主要功能

自动化浏览器操作支持多种浏览器操作，如点击、输入、拖拽等。

工具模式切换提供快照模式（默认）和视觉模式两种交互方式，满足不同需求。

多工具支持内置多个实用工具，包括截图、上传文件、保存PDF等。

优势与局限性

优势

强大的自动化能力，提升工作效率。

兼容多种设备和浏览器。

简单易用，无需复杂配置。

局限性

对网络环境有一定依赖。

部分高级功能可能需要额外付费。

如何使用

安装依赖

在项目目录下运行 `npm ci` 安装所需依赖。

构建项目

进入 `cloudflare` 文件夹后执行 `npm run build`。

部署到Cloudflare Workers

使用 `wrangler` 工具进行部署。

使用案例

打开TodoMVC示例并添加待办事项模拟用户打开TodoMVC示例应用，并创建新的待办事项。

执行一系列浏览器操作从打开页面到最终截图，展示完整的操作流程。

常见问题

如何启动Cloudflare Playwright MCP服务器？

是否支持自定义工具？

🚀 云flare工具命令参考

本项目提供了一系列云flare工具命令，涵盖选项卡管理、导航、键盘操作等多个功能，方便用户对浏览器进行各种操作。

🚀 快速开始

本项目主要提供了云flare工具的命令参考，你可以根据需求使用这些命令对浏览器进行操作。

✨ 主要特性

提供丰富的浏览器操作命令，包括选项卡管理、导航、键盘操作等。
命令参数详细，方便用户根据具体需求进行操作。

📚 详细文档

🔍 选项卡管理

命令	描述	参数
`browser_tab_list`	列出浏览器标签页	无
`browser_tab_new`	打开新标签页	`url`（字符串，可选）：要导航到的新标签页的 URL。如果未指定，则新标签页为空。
`browser_tab_select`	通过索引选择标签页	`index`（数字）：要选择的标签页的索引
`browser_tab_close`	关闭标签页	`index`（数字，可选）：要关闭的标签页的索引。如果不指定，则关闭当前标签页。

🔍 导航

命令	描述	参数
`browser_navigate`	导航到指定 URL	`url`（字符串）：要导航到的 URL
`browser_navigate_back`	返回上一页	无
`browser_navigate_forward`	前进到下一页	无

🔍 键盘操作

命令	描述	参数
`browser_press_key`	按键盘上的某个键	`key`（字符串）：要按下的键的名称或生成字符，例如 `ArrowLeft` 或 `a`

🔍 控制台

命令	描述	参数
`browser_console_messages`	返回所有控制台消息	无

🔍 文件和媒体

命令	描述	参数
`browser_file_upload`	上传一个或多个文件	`paths`（数组）：要上传的文件的绝对路径。可以是单个文件或多个文件。
`browser_pdf_save`	将页面保存为 PDF 文件	无

🔍 工具和实用程序

命令	描述	参数
`browser_close`	关闭当前窗口	无
`browser_wait`	等待指定的时间（秒）	`time`（数字）：要等待的秒数
`browser_resize`	调整浏览器窗口大小	`width`（数字）：浏览器窗口的宽度；`height`（数字）：浏览器窗口的高度
`browser_handle_dialog`	处理对话框	`accept`（布尔值）：是否接受对话框；`promptText`（字符串，可选）：提示对话框中的提示文本。