MCP 服务器

Playwright MCP Server

一个模型上下文协议服务器，使大型语言模型 (LLM) 能够与网页交互、截取屏幕截图、生成测试代码、抓取网页以及在真实的浏览器环境中执行 JavaScript。

Tools

playwright_custom_user_agent

Set a custom User Agent for the browser

playwright_get_visible_text

Get the visible text content of the current page

playwright_get_visible_html

Get the HTML content of the current page

playwright_go_back

Navigate back in browser history

playwright_go_forward

Navigate forward in browser history

start_codegen_session

Start a new code generation session to record Playwright actions

end_codegen_session

End a code generation session and generate the test file

get_codegen_session

Get information about a code generation session

clear_codegen_session

Clear a code generation session without generating a test

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_iframe_click

Click an element in an iframe on the page

playwright_fill

fill out an input field

playwright_select

Select an element on the page with Select tag

playwright_hover

Hover an element on the page

playwright_evaluate

Execute JavaScript in the browser console

playwright_console_logs

Retrieve console logs from the browser with filtering options

playwright_close

Close the browser and release all resources

playwright_get

Perform an HTTP GET request

playwright_post

Perform an HTTP POST request

playwright_put

Perform an HTTP PUT request

playwright_patch

Perform an HTTP PATCH request

playwright_delete

Perform an HTTP DELETE request

playwright_expect_response

Ask Playwright to start waiting for a HTTP response. This tool initiates the wait operation but does not wait for its completion.

playwright_assert_response

Wait for and validate a previously initiated HTTP response wait operation.

playwright_drag

Drag an element to a target location

playwright_press_key

Press a keyboard key

playwright_save_as_pdf

Save the current page as a PDF file

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 目录中生成。