SuperAPI AI 工具集

MCP-Server-Playwright

MCP Server Playwright 是一个基于模型上下文协议(MCP)的服务器,利用 Playwright 为大型语言模型(LLM)提供浏览器自动化能力。它允许 LLM 与网页进行交互,例如导航到指定 URL、截取整个页面或特定元素的截图、点击元素、填写表单、悬停、选择下拉选项以及执行 JavaScript。此外,它还支持监控浏览器控制台日志。该工具可通过 Smithery 安装到 Claude Desktop,也可用于 Cursor 代码编辑器,使 AI 能够直接在真实浏览器环境中操作。项目采用 MIT 许可证,核心目标是扩展 AI 对网页的操作和感知能力。

访问官网

工具介绍

用途

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 中使用

  1. 安装 Playwright 浏览器(如果尚未安装):npx playwright install
  2. 使用 Smithery 为 Cursor 安装 MCP Server Playwright:npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client cursor
  3. 配置文件设置:如果不使用 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 文件。