Automata Labs Team MCP Server Playwright

🚀 MCP Server Playwright

This is a Model Context Protocol (MCP) server implemented with Playwright, which offers browser automation capabilities. It enables large language models to interact with web pages, capture screenshots, and execute JavaScript in the browser environment.

🚀 Quick Start

This MCP server based on Playwright is designed to provide browser automation functions. With this server, large language models can interact with web pages, including taking screenshots and executing JavaScript operations.

📦 Installation

Using Smithery

You can install it using the following command:

smith install @automatalabs/mcp-server-playwright

Using CLI Tool

You can also install it via the Node.js package manager:

npm install @automatalabs/mcp-server-playwright

📚 Documentation

Configuration

The project's configuration file is typically a JSON file. Here is an example:

{
  "serverPort": 3000,
  "playwrightConfig": {
    "devices": {
      "Desktop Chrome": {
        "browserName": "chromium",
        "isMobile": false,
        "viewport": { "width": 1920, "height": 1080 }
      }
    }
  }
}

Components

Tools

The following are the main tools provided by this server:

1. Navigation (playwright_navigate)

   • Function: Navigate to a specified URL.
   • Usage:

     { "command": "playwright_navigate", "args": { "url": "https://example.com" } }
     

2. Take Screenshot (playwright_screenshot)

   • Function: Capture a screenshot of the current page.
   • Usage:

     { "command": "playwright_screenshot", "args": { "name": "screenshot-name" } }
     

3. Execute JavaScript (playwright_evaluate)

   • Function: Execute arbitrary JavaScript code in the browser context.
   • Usage:

     { "command": "playwright_evaluate", "args": { "script": "document.title" } }
     

4. Input Text (playwright_fill)

   • Function: Fill in form fields.
   • Usage:

     { "command": "playwright_fill", "args": { "selector": "#input-field", "value": "Hello World" } }
     

5. Select Dropdown (playwright_select)

   • Function: Select a specified value from a dropdown list.
   • Usage:

     { "command": "playwright_select", "args": { "selector": "#dropdown", "value": "option-value" } }
     

Resources

1. Console Logs (console://logs)

   • Type: Text file
   • Description: Access the log information output by the browser console.

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

   • Type: PNG image file
   • Description: Reference the captured screenshots by name.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.