MCP 服务器

mcp-playwright

一个模型上下文协议（Model Context Protocol）服务器，它使用 Playwright 提供浏览器自动化功能。该服务器使大型语言模型（LLMs）能够与网页交互、截取屏幕截图，并在真实的浏览器环境中执行 JavaScript。

远程shell执行

网络自动化与隐身

AI集成系统

访问服务器

Tools

playwright_post

Perform an HTTP POST request

playwright_hover

Hover an element on the page

playwright_put

Perform an HTTP PUT request

playwright_fill

fill out an input field

playwright_evaluate

Execute JavaScript in the browser console

playwright_get

Perform an HTTP GET request

playwright_select

Select an element on the page with Select tag

playwright_iframe_click

Click an element in an iframe on the page

playwright_navigate

Navigate to a URL

playwright_screenshot

Take a screenshot of the current page or a specific element

playwright_click

Click an element on the page

playwright_patch

Perform an HTTP PATCH request

playwright_delete

Perform an HTTP DELETE request

README

Playwright MCP 服务器 🎭

一个模型上下文协议 (Model Context Protocol) 服务器，提供使用 Playwright 的浏览器自动化功能。此服务器使 LLM 能够与网页交互、截取屏幕截图、生成测试代码、抓取网页内容以及在真实的浏览器环境中执行 JavaScript。

截图

Playwright + Claude

文档 | API 参考

安装

您可以使用 npm、mcp-get 或 Smithery 安装此包：

使用 npm:

npm install -g @executeautomation/playwright-mcp-server

使用 mcp-get:

npx @michaellatman/mcp-get@latest install @executeautomation/playwright-mcp-server

使用 Smithery

要通过 Smithery 自动为 Claude Desktop 安装 Playwright MCP：

npx -y @smithery/cli install @executeautomation/playwright-mcp-server --client claude

在 VS Code 中安装

使用以下按钮之一在 VS Code 中安装 Playwright MCP 服务器：

或者，您可以使用 VS Code CLI 安装 Playwright MCP 服务器：

# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}'

# For VS Code Insiders
code-insiders --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}'

安装完成后，ExecuteAutomation Playwright MCP 服务器将可用于 VS Code 中的 GitHub Copilot 代理。

配置以使用 Playwright 服务器

以下是使用 Playwright 服务器的 Claude Desktop 配置：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/playwright-mcp-server"]
    }
  }
}

测试

此项目使用 Jest 进行测试。测试位于 src/__tests__ 目录中。

运行测试

您可以使用以下命令之一运行测试：

# Run tests using the custom script (with coverage)
node run-tests.cjs

# Run tests using npm scripts
npm test           # Run tests without coverage
npm run test:coverage  # Run tests with coverage
npm run test:custom    # Run tests with custom script (same as node run-tests.cjs)

测试覆盖率报告将在 coverage 目录中生成。