MCP.so
Sign In

mcp-server-playwright

@hdcola

Repository

About mcp-server-playwright

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-playwright": {
      "command": "bun",
      "args": [
        "yourpath/mcp-server-playwright/src/index.ts"
      ],
      "env": {
        "CHROME_PATH": "",
        "MUSER_DATA_DIR": ""
      }
    }
  }
}

Tools

6

browser(url) : Open a browser with the specified URL(option).

page(pageNumber: int) : Close a desiginated page in current browser.

browser() : Close the browser.

page(url) : Navigate to the specified URL.

page(url) : Open a page in a new tab.

content() : Get the readability content of the current page.

Overview

What is mcp-server-playwright?

mcp-server-playwright is an experimental MCP server that uses Playwright to control a browser, enabling AI-driven browser automation. It provides a set of tools to open, close, and navigate browser pages programmatically.

How to use mcp-server-playwright?

Install dependencies with pnpm install (requires bun and pnpm). Configure your MCP client with the JSON shown in the README, setting the CHROME_PATH and MUSER_DATA_DIR environment variables. Then invoke the available tools through your MCP client.

Key features of mcp-server-playwright

  • Open a browser with an optional URL.
  • Close a specific page by page number.
  • Close the entire browser.
  • Navigate to a specified URL.
  • Open a new page in a new tab.
  • Get readability content of the current page.

Use cases of mcp-server-playwright

  • Automate web browsing tasks via AI assistants.
  • Extract readable content from web pages programmatically.
  • Control multiple browser tabs for testing or scraping.
  • Integrate browser actions into MCP-powered workflows.

FAQ from mcp-server-playwright

What runtime dependencies does it require?

It requires bun and pnpm installed on your system. The server is run with bun.

How do I configure the Chrome browser path?

Set the CHROME_PATH environment variable in the MCP configuration to the path of your Chrome executable. Also set MUSER_DATA_DIR to your Chrome user data directory.

What tools are available?

Tools include: open-browser, close-page, close-browser, navigate-to-page, open-new-page, and get-page-content. Each tool has its own parameters as described in the README.

Is this project production-ready?

No, it is described as an experimental project aimed at implementing browser control through AI.

Where does the browser data live?

The user data directory is specified via the MUSER_DATA_DIR environment variable, which points to the Chrome user data path on your local machine.

Frequently asked questions

What runtime dependencies does it require?

It requires `bun` and `pnpm` installed on your system. The server is run with `bun`.

How do I configure the Chrome browser path?

Set the `CHROME_PATH` environment variable in the MCP configuration to the path of your Chrome executable. Also set `MUSER_DATA_DIR` to your Chrome user data directory.

What tools are available?

Tools include: `open-browser`, `close-page`, `close-browser`, `navigate-to-page`, `open-new-page`, and `get-page-content`. Each tool has its own parameters as described in the README.

Is this project production-ready?

No, it is described as an experimental project aimed at implementing browser control through AI.

Where does the browser data live?

The user data directory is specified via the `MUSER_DATA_DIR` environment variable, which points to the Chrome user data path on your local machine.

Comments

Basic information

Category

Browser Automation

License

MIT

Transports

stdio

Author

hdcola

More Browser Automation MCP servers

Browser Control MCP

eyalzh

MCP server paired with a browser extension that enables AI agents to control the user's browser.

299

HTML/CSS to Image

An MCP server for generating images from HTML & CSS or screenshots of URLs using htmlcsstoimage.com.

Playwright MCP Server 🎭

executeautomation

Playwright Model Context Protocol Server - Tool to automate Browsers and APIs in Claude Desktop, Cline, Cursor IDE and More 🔌

5.6K

browser-mcp

djyde

A browser extension and MCP server that allows you to interact with the browser you are using.

83

mcp-browser-use: MCP server for browser-use

vinayak-mehta

MCP server for browser-use

81