MCP Server Playwright

by aptcats

391 downloads
Not rated
GitHub

About

MCP Server Playwright - A browser automation service for Claude Desktop

Details

Author
aptcats
Downloads
391
Categories
Automation

- Full browser automation with Playwright
- Capture screenshots of full pages or specific elements
- Comprehensive web interaction (navigation, clicking, form filling)
- Monitor browser console logs in real time
- Execute JavaScript in the browser context

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Server Playwright
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the server using npx @automatalabs/mcp-server-playwright install or via Smithery (npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude). The installer automatically updates your Claude desktop configuration. Once configured, invoke browser tools like browser_navigate, browser_screenshot, browser_click, browser_fill, and browser_evaluate from your MCP client.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server playwright": {
            "mcp-server-playwright": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@automatalabs/mcp-server-playwright",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-playwright": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@automatalabs/mcp-server-playwright",
            "--client",
            "claude"
        ]
    }
}

MCP Server Playwright

Table of Contents

- Features - Installation - Configuration - Components - Tools - Resources - License

Features

- 🌐 Full browser automation capabilities - πŸ“Έ Screenshot capture of entire pages or specific elements - πŸ–±οΈ Comprehensive web interaction (navigation, clicking, form filling) - πŸ“Š Console log monitoring - πŸ”§ JavaScript execution in browser context

Installation

Installing via Smithery

To install MCP Server Playwright for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude

You can install the package using either npx or mcp-get:

Using npx:

npx @automatalabs/mcp-server-playwright install

This command will:
- Check your operating system compatibility (Windows/macOS)
- Create or update the Claude configuration file
- Configure the Playwright server integration

The configuration file will be automatically created/updated at:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Using mcp-get:

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

Configuration

The installation process will automatically add the following configuration to your Claude config file:
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

Components

Tools

browser_navigate

Navigate to any URL in the browser
{
  "url": "https://stealthbrowser.cloud"
}

browser_screenshot

Capture screenshots of the entire page or specific elements
{
  "name": "screenshot-name",     // required
  "selector": "#element-id",     // optional
  "fullPage": true              // optional, default: false
}

browser_click

Click elements on the page using CSS selector
{
  "selector": "#button-id"
}

browser_click_text

Click elements on the page by their text content
{
  "text": "Click me"
}

browser_hover

Hover over elements on the page using CSS selector
{
  "selector": "#menu-item"
}

browser_hover_text

Hover over elements on the page by their text content
{
  "text": "Hover me"
}

browser_fill

Fill out input fields
{
  "selector": "#input-field",
  "value": "Hello World"
}

browser_select

Select an option in a SELECT element using CSS selector
{
  "selector": "#dropdown",
  "value": "option-value"
}

browser_select_text

Select an option in a SELECT element by its text content
{
  "text": "Choose me",
  "value": "option-value"
}

browser_evaluate

Execute JavaScript in the browser console
{
  "script": "document.title"
}

Resources

Console Logs (console://logs)

- Access browser console output in text format - Includes all console messages from the browser

Screenshots (screenshot://<n>)

- Access PNG images of captured screenshots - Referenced by the name specified during capture

License

MIT License
No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.