📌Overview

Purpose: To provide a Model Context Protocol server that facilitates browser automation using Playwright, allowing LLMs to interact with web content effectively.

Overview: The Playwright MCP Server delivers robust browser automation capabilities, enabling the execution of JavaScript, web scraping, taking screenshots, and generating test code within a real browser environment. This server is designed to enhance the functionality of large language models (LLMs) when interacting with web pages.

Key Features:

Browser Automation: Enables LLMs to control and automate web browser tasks, enhancing interactivity with web pages.
JavaScript Execution: Allows for direct execution of JavaScript in the browser context, facilitating dynamic web interactions and testing.
Page Screenshot Capabilities: Provides the ability to capture screenshots of web pages, aiding in visual testing and documentation.
Test Code Generation: Automatically generates test scripts to streamline the testing process for web applications.
Web Scraping: Supports extracting information from web pages, making it easier to gather data for analysis or further processing.

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 scrape the page, and execute JavaScript in a real browser environment.

Documentation

Installation

You can install the package using 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 via Smithery:

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

Configuration

Configuration for Claude Desktop to use the Playwright server:

{
  "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:

# 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

The test coverage report will be generated in the coverage directory.

mcp-playwright