用途
MCP Server Playwright 是一个 Model Context Protocol(MCP)服务器,旨在为大型语言模型(LLM)提供浏览器自动化能力。它基于 Playwright 构建,使 LLM 能够与网页交互、截取屏幕截图并在真实的浏览器环境中执行 JavaScript。
主要能力
根据官方资料,该服务器提供以下工具与资源:
- 完整的浏览器自动化能力:导航到任意 URL、点击页面元素(通过 CSS 选择器或文本内容)、悬停元素(通过 CSS 选择器或文本内容)、填写输入字段、在 SELECT 元素中选择选项(通过 CSS 选择器或文本内容)。
- 屏幕截图捕获:可截取整个页面或特定元素,并通过 screenshot://<n> 资源访问 PNG 图像。
- 控制台日志监控:可通过 console://logs 资源以文本格式访问浏览器控制台输出,包括所有控制台消息。
- 在浏览器上下文中执行 JavaScript。
使用方式
官方提供了通过 Smithery 安装的方式,支持 Claude Desktop 和 Cursor 编辑器。
安装到 Claude Desktop
可通过 Smithery 自动安装。安装命令使用 npx 或 mcp-get(资料中未提供具体命令内容)。该命令会:检查操作系统兼容性(Windows/macOS)、创建或更新 Claude 配置文件、配置 Playwright 服务器集成。配置文件会自动创建/更新在:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
在 Cursor 中使用
- 安装 Playwright 浏览器(如果尚未安装):npx playwright install
- 使用 Smithery 为 Cursor 安装 MCP Server Playwright:npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client cursor
- 配置文件设置:如果不使用 Claude,配置文件(claude_desktop_config.json)可能不会自动创建。在 Windows 上,需在 %APPDATA%(通常为 C:\Users<YourName>\AppData\Roaming)中创建名为 Claude 的文件夹,并在该文件夹内创建 claude_desktop_config.json 文件,内容为:{ "serverPort" : 3456 }。之后按照安装部分的剩余步骤完成设置。
完成设置后,即可在 Cursor 的 AI 功能中使用 MCP Server Playwright 提供的所有浏览器自动化工具,例如网页导航、截图捕获和 JavaScript 执行。
注意:确保已安装 Node.js 且 npx 在系统 PATH 中可用。
适用场景
适用于需要让 LLM 或 AI 助手直接操作浏览器的场景,如自动化网页交互、信息提取、页面测试、截图记录等。可集成到 Claude Desktop 或 Cursor 等支持 MCP 的客户端中。
限制
资料中未提供关于收费、平台限制、性能或效果方面的具体说明。项目采用 MIT 许可证,详情请参阅 LICENSE 文件。