Skip to main content
Glama
MCP-Server-Playwright

MCP-Server-Playwright

by VikashLoomba

Table of Contents

Related MCP server: Playwright MCP Server for Security

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:

  1. Check your operating system compatibility (Windows/macOS)

  2. Create or update the Claude configuration file

  3. 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"]
    }
  }
}

Using with Cursor

You can also use MCP Server Playwright with Cursor, an AI-powered code editor. To enable browser automation in Cursor via MCP:

  1. Install Playwright browsers (if not already):

    npx playwright install
  2. Install MCP Server Playwright for Cursor using Smithery:

    npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client cursor
  3. Configuration file setup:
    If you do not use Claude, the configuration file (claude_desktop_config.json) may not be created automatically.

    • On Windows, create a folder named Claude in %APPDATA% (usually C:\Users\<YourName>\AppData\Roaming\Claude).

    • Inside that folder, create a file named claude_desktop_config.json with the following content:

    {
      "serverPort": 3456
    }
  4. Follow the remaining steps in the Installation section above to complete the setup.

Now, you can use all the browser automation tools provided by MCP Server Playwright directly from Cursor’s AI features, such as web navigation, screenshot capture, and JavaScript execution.

Note: Make sure you have Node.js installed and npx available in your system PATH.

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

  1. Console Logs (console://logs)

    • Access browser console output in text format

    • Includes all console messages from the browser

  2. Screenshots (screenshot://<n>)

    • Access PNG images of captured screenshots

    • Referenced by the name specified during capture

License

This project is licensed under the MIT License - see the LICENSE file for details.

Available Tools

10 tools
browser_clickB

Click an element on the page using CSS selector

Inputs: selector (required).

browser_click_textB

Click an element on the page by its text content

Inputs: text (required).

browser_evaluateC

Execute JavaScript in the browser console

Inputs: script (required).

browser_fillB

Fill out an input field

Inputs: selector (required), value (required).

browser_hoverA

Hover an element on the page using CSS selector

Inputs: selector (required).

browser_hover_textB

Hover an element on the page by its text content

Inputs: text (required).

browser_navigateC

Navigate to a URL

Inputs: url (required).

browser_screenshotB

Take a screenshot of the current page or a specific element

Inputs: name (required), selector, fullPage.

browser_selectC

Select an element on the page with Select tag using CSS selector

Inputs: selector (required), value (required).

browser_select_textC

Select an element on the page with Select tag by its text content

Inputs: text (required), value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose. Pairwise similar tools like click and click_text are differentiated by CSS selector vs text content, making ambiguity minimal.

    Naming Consistency5/5

    All tools follow a consistent 'browser_verb' pattern, with optional '_text' suffix for text-based selectors. Snake_case is used uniformly.

    Tool Count5/5

    10 tools is an appropriate number for browser automation, covering essential actions without being overwhelming. The scope is well-defined.

    Completeness4/5

    The set covers core browser interactions (navigation, click, fill, select, hover, evaluate, screenshot). Missing operations like waiting, scrolling, or keyboard input are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers