Playwright Plus

🚀 Playwright Server MCP Service

A Playwright server with MCP tools This project provides a Playwright server integrated with MCP tools, offering various functionalities for note management and web automation. Click here to access

✨ Features

Resources

The server implements a simple note storage system with the following features:

• A custom note:// URI scheme for accessing individual notes.
• Each note resource includes a name, description, and text/plain MIME type.

Prompts

The server offers a prompt:

• summarize-notes: Generate a summary of all stored notes.
  • An optional parameter "style" to control the level of detail (concise/detailed).
  • Generate prompts based on all current notes, giving priority to style preferences.

Tools

The server implements the following tools:

• playwright_navigate: Navigate to a specified URL. If there is no active session, this operation will automatically create a new one.
  • Requires a url parameter (string).
• playwright_screenshot: Take a screenshot of the current page or a specific element.
  • Requires a name parameter (string) as the screenshot file name.
  • An optional selector parameter (string) to specify a CSS selector for taking a screenshot of a specific element. If no selector is provided, a full-page screenshot will be taken.
• playwright_click: Click an element on the page via a CSS selector.
  • Requires a selector parameter (string) to specify the CSS selector of the element to click.
• playwright_fill: Fill the content of an input field.
  • Requires a selector parameter (string) to specify the CSS selector of the input field.
  • Requires a value parameter (string) to specify the value to fill.
• playwright_evaluate: Execute JavaScript code in the browser console.
  • Requires a script parameter (string) to specify the JavaScript script to execute.
• playwright_click_text: Click an element on the page via its text content.
  • Requires a text parameter (string) to specify the text content of the element to click.
• playwright_get_element_attribute: Get the attribute value of an element.
  • Requires two parameters: selector (string, specifying the CSS selector of the element) and attribute_name (string, specifying the name of the attribute to get).
  • Returns the attribute value of the specified element.

📚 Documentation

MCP Desktop Configuration Path

Windows: %APPDATA%\MCP\config.json
Linux: ~/.config/MCP/config.json

🔧 Technical Details

Release Steps

1. Run the uv build command to perform the build.
2. Execute uv package to generate the release package.
3. Use uv install to install the service.

Debugging Method

Execute the following command to start debugging:

npm run dev

💻 Usage Examples

MCP Desktop Example Path

{
  "playwright_server": {
    "enabled": true,
    "path": "C:/Users/Administrator/AppData/MCP/config.json"
  }
}

MCP Inspector Example Command

npm run dev -- --port 9234