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