Playwright MCP

Playwright wrapper for MCP (Model Context Protocol). This server enables LLM-powered clients to control a browser for automation tasks.

The server exposes resources for accessing browser screenshots:

- Screenshot resource URI:screenshot://{page_id}
- Screenshot resources are automatically available for all open pages

The server provides a prompt to help clients interpret web pages:

- interpret-page: Analyzes the current web page content and structure

- Optionalpage_idargument to select which page to interpret
- Optionalfocusargument to focus on specific aspects (full, forms, navigation, text)
- Returns both text analysis and a screenshot of the page

The server implements a comprehensive set of browser automation tools:

- navigate: Go to a specific URL
- new_page: Create a new browser page with a specific ID
- switch_page: Switch to a different browser page
- get_pages: List all available browser pages

- click: Click on an element using CSS selector
- type: Type text into an input element
- wait_for_selector: Wait for an element to appear on the page

- get_text: Get text content from an element
- get_page_content: Get the entire page HTML
- take_screenshot: Capture visual state of the page or element

uv add playwright playwright install chromium

On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows:%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": { "playwright-mcp": { "command": "uv", "args": [ "--directory", "/Users/shannon/Workspace/artivus/playwright-mcp", "run", "playwright-mcp" ] } }

"mcpServers": { "playwright-mcp": { "command": "uvx", "args": [ "playwright-mcp" ] } }

To prepare the package for distribution:

This will create source and wheel distributions in thedist/directory.

Note: You'll need to set PyPI credentials via environment variables or command flags:

- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.

You can launch the MCP Inspector vianpmwith this command:

npx @modelcontextprotocol/inspector uv --directory /Users/shannon/Workspace/artivus/playwright-mcp run playwright-mcp

Automate browser tasks using the Browser Use API.