Repository files navigation

MseeP.ai Security Assessment	Special thanks toWarp, the AI terminal for developers

---

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.

You can install the package using either npm, mcp-get, or Smithery:

Using npm:

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

Using mcp-get:

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

Using Smithery

To install Playwright MCP for Claude Desktop automatically viaSmithery:

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

Install the Playwright MCP server in VS Code using one of these buttons:

Alternatively, you can install the Playwright MCP server using the VS Code CLI:

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

# For VS Code Insiderscode-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.

Here's the Claude Desktop configuration to use the Playwright server:

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

This project uses Jest for testing. The tests are located in thesrc/__tests__ directory.

You can run the tests using one of the following commands:

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

The test coverage report will be generated in thecoverage directory.

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 foundhere.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/tools/codegen/index.ts

When adding new tools, please be mindful of the tool name length. Some clients, like Cursor, have a 60-character limit for the combined server and tool name (server_name:tool_name).

Our server name isplaywright-mcp. Please ensure your tool names are short enough to not exceed this limit.