# mcp-playwright **Repository Path**: mirrors/mcp-playwright ## Basic Information - **Project Name**: mcp-playwright - **Description**: Playwright MCP Server 是为大模型 LLM 提供浏览器自动化能力的工具: - **Primary Language**: TypeScript - **License**: MIT - **Default Branch**: main - **Homepage**: https://www.oschina.net/p/mcp-playwright - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 0 - **Created**: 2025-03-28 - **Last Updated**: 2025-04-24 ## Categories & Tags **Categories**: Artificial-Intelligence, MCP **Tags**: None ## README
MseeP.ai Security Assessment Badge Warp sponsorship
MseeP.ai Security Assessment Special thanks to Warp, the AI terminal for developers

# Playwright MCP Server 🎭 [![smithery badge](https://smithery.ai/badge/@executeautomation/playwright-mcp-server)](https://smithery.ai/server/@executeautomation/playwright-mcp-server) A Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, generate test code, web scraps the page and execute JavaScript in a real browser environment. mcp-playwright MCP server ## Screenshot ![Playwright + Claude](image/playwright_claude.png) ## [Documentation](https://executeautomation.github.io/mcp-playwright/) | [API reference](https://executeautomation.github.io/mcp-playwright/docs/playwright-web/Supported-Tools) ## Installation You can install the package using either npm, mcp-get, or Smithery: Using npm: ```bash npm install -g @executeautomation/playwright-mcp-server ``` Using mcp-get: ```bash npx @michaellatman/mcp-get@latest install @executeautomation/playwright-mcp-server ``` Using Smithery To install Playwright MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@executeautomation/playwright-mcp-server): ```bash npx @smithery/cli install @executeautomation/playwright-mcp-server --client claude ``` #### Installation in VS Code Install the Playwright MCP server in VS Code using one of these buttons: [Install in VS Code](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540executeautomation%252Fplaywright-mcp-server%2522%255D%257D) [Install in VS Code Insiders](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540executeautomation%252Fplaywright-mcp-server%2522%255D%257D) Alternatively, you can install the Playwright MCP server using the VS Code CLI: ```bash # For VS Code code --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}' ``` ```bash # For VS Code Insiders code-insiders --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}' ``` After installation, the ExecuteAutomation Playwright MCP server will be available for use with your GitHub Copilot agent in VS Code. ## Configuration to use Playwright Server Here's the Claude Desktop configuration to use the Playwright server: ```json { "mcpServers": { "playwright": { "command": "npx", "args": ["-y", "@executeautomation/playwright-mcp-server"] } } } ``` ## Testing This project uses Jest for testing. The tests are located in the `src/__tests__` directory. ### Running Tests You can run the tests using one of the following commands: ```bash # 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) ``` The test coverage report will be generated in the `coverage` directory. ### Running evals The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs). ```bash OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/tools/codegen/index.ts ``` ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=executeautomation/mcp-playwright&type=Date)](https://star-history.com/#executeautomation/mcp-playwright&Date)