MCP Server Playwright

MCP Server Playwright

By aptcats GitHub

MCP Server Playwright - A browser automation service for Claude Desktop

Overview

what is MCP Server Playwright?

MCP Server Playwright is a browser automation service designed for Claude Desktop, enabling users to automate web interactions seamlessly.

how to use MCP Server Playwright?

To use MCP Server Playwright, install it via Smithery or using npx commands, and configure it according to your operating system. Once installed, you can utilize various tools for browser navigation, screenshot capture, and more.

key features of MCP Server Playwright?

  • 🌐 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

use cases of MCP Server Playwright?

  1. Automating repetitive web tasks such as form submissions.
  2. Capturing screenshots for testing or documentation purposes.
  3. Monitoring console logs for debugging web applications.

FAQ from MCP Server Playwright?

  • Can MCP Server Playwright be used on any operating system?

Yes! It supports both Windows and macOS.

  • Is there a graphical interface for MCP Server Playwright?

No, it operates through command-line interfaces and scripts.

  • How can I capture a screenshot of a specific element?

Use the browser_screenshot tool with the appropriate selector.

Content

MCP Server Playwright

Table of Contents

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://)

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

License

MIT License

No tools information available.
No content found.