Playwright

The Playwright MCP Server lets you run a browser automation environment that your MCP client can control. It provides real browser actions through Playwright, enabling you to interact with web pages, take screenshots, generate test code, scrape content, and run JavaScript in a real browser.

How to use

You connect to the Playwright MCP Server from your MCP client and issue high‑level actions that the server translates into browser commands. Use it to automate page interactions, capture visuals for verification, generate test code from pages, and extract data from web content. The server runs as a local or remote process and is invoked via a simple command line launcher in your project.

How to install

Prerequisites: you need Node.js and npm installed on your system. If you do not have them, install Node.js from https://nodejs.org and npm will come bundled.

Install the Playwright MCP Server globally using npm:

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

Configuration to use Playwright Server

Configure your MCP client to connect to the Playwright server by adding the following MCP server entry. This uses npx to run the server when you start your client session.

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

Testing

Use the provided test setup to verify that the Playwright MCP Server starts and responds to your MCP client. Tests are written with Jest and can be run from the project’s test suite. The tests exercise browser interactions, screenshot capture, and simple page scrapes to ensure the server behaves as expected.

Commands to run tests are documented in the testing section of the project setup.

Notes

You can also run the server via the CLI toolchain in various environments. If you are using a development environment like VS Code, you can attach your MCP client to the Playwright MCP Server using the standard MCP configuration shown above.

Contributing

When you add new capabilities, keep tool names concise and within the 20‑character limit for identifiers. Ensure the server name remains clearly identifiable as a Playwright MCP Server.

Available tools

navigate

Navigate to a web page or URL within the automated browser context.

screenshot

Capture a screenshot of the current page, with options to specify viewport and full-page capture.

codegen

Generate test or interaction code based on the current session to accelerate test development.

scrape

Extract text, attributes, and structured data from the loaded page for data collection.

eval_js

Execute JavaScript in the context of the loaded page and return results.