Playwright MCP Server

English | 日本語

This project is a server that provides Playwright web page content retrieval functionality using the Model Context Protocol (MCP).

Features

• Page navigation

• Full page content retrieval

• Visible content retrieval

• Interactive elements detection

• Mouse operation simulation

• Echo functionality for testing

Installation

Installing via Smithery

To install Playwright MCP Server for Claude Desktop automatically via Smithery:

Manual Installation

Usage

Starting the Server

MCP Tools

The following tools are available:

1. navigate

   • Navigate to a specified URL

   • Arguments: { url: string }

   • Returns: Navigation result

2. get_all_content

   • Retrieve content from the entire page

   • Arguments: None

   • Returns: All text content from the page

3. get_visible_content

   • Retrieve currently visible content

   • Arguments: { minVisiblePercentage?: number }

   • Returns: Visible text content

4. get_interactive_elements

   • Get position information of interactive elements (buttons, links, etc.) on the page

   • Arguments: None

   • Returns: Coordinates and boundary information of interactive elements

5. move_mouse

   • Move mouse cursor to specified coordinates

   • Arguments: { x: number, y: number }

   • Returns: Operation result

6. mouse_click

   • Execute mouse click at specified coordinates

   • Arguments: { x: number, y: number, button?: "left" | "right" | "middle", clickCount?: number }

   • Returns: Click operation result

7. mouse_wheel

   • Execute mouse wheel scrolling

   • Arguments: { deltaY: number, deltaX?: number }

   • Returns: Scroll operation result

8. drag_and_drop

   • Execute drag and drop operation

   • Arguments: { sourceX: number, sourceY: number, targetX: number, targetY: number }

   • Returns: Drag and drop operation result

9. echo

   • Echo tool for testing

   • Arguments: { message: string }

   • Returns: Sent message

Development

Running Tests

Test Structure

• tools/*.test.ts: Function tests for each tool

• mcp-server.test.ts: MCP server function tests

Implementation Features

1. Content Retrieval

   • Full page content retrieval

   • Visible content only retrieval

   • Proper HTML parsing

2. Interaction

   • Detection and position information retrieval of interactive elements

   • Mouse operation simulation (movement, clicks, scrolling)

   • Drag and drop support

3. Error Handling

   • Proper navigation error handling

   • Timeout processing

   • Invalid URL detection

4. Configuration Flexibility

   • Headless/head mode selection

   • Custom user agent

   • Viewport size settings

Important Notes

• Ensure necessary environment variables are set before using the MCP server

• Follow the terms of service of target websites when retrieving web page content

• Maintain appropriate intervals when sending multiple requests

• When performing mouse operations, maintain appropriate intervals as they simulate actual user interactions

License

ISC