Back to search
playwright-mcp
MCP serverGitHub
Playwright MCP fork that works with Cloudflare Browser Rendering
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/cloudflare--playwright-mcp)HTML
<a href="/listings/cloudflare--playwright-mcp"><img src="/api/listings/cloudflare--playwright-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 508 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ## Cloudflare Playwright MCP
- [](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/playwright-mcp/tree/main/cloudflare/example)
- ### Overview
- This project leverages Playwright for automated browser testing and integrates with Cloudflare Workers, [Browser Rendering](https://developers.cloudflare.com/browser-rendering/) and [`@cloudflare/playwright`](https://github.com/cloudflare/playwright) for deployment.
- ### Build and Deploy
- Follow these steps to set up and deploy the project:
- 1. Install dependencies:
- ```bash
- npm ci
- ```
- 2. Build:
- ```bash
- cd cloudflare
- npm run build
- ```
- 3. Deploy to Cloudflare Workers:
- ```bash
- cd cloudflare/example
- npm ci
- npx wrangler deploy
- ```
- ### Use with Cloudflare AI Playground
- 
- [Cloudflare playground AI](https://playground.ai.cloudflare.com/) is a great way to test MCP servers using LLM models available in Workers AI.
- - Navigate to https://playground.ai.cloudflare.com/
- - Ensure model is set to `llama-3.3-70b-instruct-fp8-fast`
- - In **MCP Servers**, set **URL** to `https://[my-mcp-url].workers.dev/sse`
- - Click **Connect**
- - Status should update to **Connected** and it should list 14 available tools
- You can now start to interact with the model, and it will run necessary tools to accomplish what was requested.
- > [!TIP]
- > For best results, give simple instructions consisting of one single action, e. g., "Create a new todo entry", "Go to cloudflare site", "Take a screenshot"
- Example of a conversation:
- | Role | Message |
- |------|---------|
- | **User** | Go to demo.playwright.dev/todomvc |
- | **Assistant** | *runs browser_navigate tool*<br> The page has been navigated to https://demo.playwright.dev/todomvc/. The page title is "React • TodoMVC". The page snapshot shows the content of the page, including a heading, a textbox, and several links. |
- | **User** | Create some todo entry |
- | **Assistant** | *runs browser_type tool*<br> A new todo entry "Buy groceries" has been created. The page snapshot shows the updated content of the page, including the new todo entry. |
- | **User** | Nice. Now create a todo in parrot style |
- | **Assistant** | *runs browser_type tool*<br> A new todo entry "Polly wants a cracker" has been created in parrot style. The page snapshot shows the updated content of the page, including the new todo entry. |
- | **User** | And create another todo in yoda style |
- | **Assistant** | *runs browser_type tool*<br> A new todo entry "A walk, I must take" has been created in Yoda style. The page snapshot shows the updated content of the page, including the new todo entry. |
- | **User** | Take a screenshot |
- | **Assistant** | *runs browser_take_screenshot tool*<br>  A screenshot of the current page has been taken. The screenshot is in PNG format and is 56KB in size. |
- | **User** | Now click the checkbox of the parrot todo entry |
- | **Assistant** | *runs browser_clickt tool*<br> The checkbox of the parrot todo entry "Polly wants a cracker" has been clicked. The page snapshot shows the updated content of the page, with the checkbox now checked. |
- | **User** | Take a screenshot |
- | **Assistant** | *runs browser_take_screenshot tool*<br>  A screenshot of the current page has been taken. The screenshot is in PNG format and is 58KB in size. |
- | **User** | Remove completed todo entries |
- | **Assistant** | *runs browser_clickt tool*<br> The "Clear completed" button has been clicked. The page snapshot shows the updated content of the page, with the completed todo entry "Polly wants a cracker" removed. |
- | **User** | Take a final screenshot |
- | **Assistant** | *runs browser_take_screenshot tool*<br>  A final screenshot of the current page has been taken. The screenshot is in PNG format and is 50KB in size. |
- ### Use with Claude Desktop
- As of now, [Claude Desktop](https://claude.ai/download) only supports local MCP servers. To use `playground-mcp` with Claude Desktop we make use of [mcp-remote](https://github.com/geelen/mcp-remote), a tool that proxies remote MCP servers and exposes them locally. Use the following configuration:
- 1. Open the configuration file for Claude Desktop.
- 2. Add the following JSON snippet under the `mcpServers` section:
- ```json
- {
- "mcpServers": {
- "cloudflare-playwright-mcp": {
- "command": "npx",
- "args": [
- "mcp-remote",
- "https://[my-mcp-url].workers.dev/sse"
- ]
- }
- }
- }
- ```
- 3. Save the configuration file and **restart** Claude Desktop to apply the changes.
- This setup ensures that Claude Desktop can communicate with the Cloudflare Playwright MCP server.
- Here's an example of a session opening the TODO demo app, adding "buy lemons" and doing a screenshot, taking advantage of playwright-mcp tools and Browser Rendering:
- 
- ### Configure in VSCode
- You can install the Playwright MCP server using the [VS Code CLI](https://code.visualstudio.com/docs/configure/command-line):
- ```bash
- # For VS Code
- code --add-mcp '{"name":"cloudflare-playwright","type":"sse","url":"https://[my-mcp-url].workers.dev/sse"}'
- ```
- ```bash
- # For VS Code Insiders
- code-insiders --add-mcp '{"name":"cloudflare-playwright","type":"sse","url":"https://[my-mcp-url].workers.dev/sse"}'
- ```
- After installation, the Playwright MCP server will be available for use with your GitHub Copilot agent in VS Code.
- ### Use with Cursor
- By default, when `imageResponses` is set to `"auto"`, the server disables inline image responses for Cursor clients. To enable inline screenshots in Cursor, you need to override this behavior:
- If you're running your own Cloudflare Worker, pass `imageResponses: "allow"` when creating the MCP agent:
- ```typescript
- export const PlaywrightMCP = createMcpAgent(env.BROWSER, {
- imageResponses: 'allow',
- } as any);
- ```
- ### Tool Modes
- The tools are available in two modes:
- 1. **Snapshot Mode** (default): Uses accessibility snapshots for better performance and reliability
- 2. **Vision Mode**: Uses screenshots for visual-based interactions
- Vision Mode works best with the computer use models that are able to interact with elements using
- X Y coordinate space, based on the provided screenshot.
- <!--- Tools generated by update-readme.js -->
- <details>
- <summary><b>Interactions</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_snapshot**
- - Title: Page snapshot
- - Description: Capture accessibility snapshot of the current page, this is better than screenshot
- - Parameters: None
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_click**
- - Title: Click
- - Description: Perform click on a web page
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `ref` (string): Exact target element reference from the page snapshot
- - `doubleClick` (boolean, optional): Whether to perform a double click instead of a single click
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_drag**
- - Title: Drag mouse
- - Description: Perform drag and drop between two elements
- - Parameters:
- - `startElement` (string): Human-readable source element description used to obtain the permission to interact with the element
- - `startRef` (string): Exact source element reference from the page snapshot
- - `endElement` (string): Human-readable target element description used to obtain the permission to interact with the element
- - `endRef` (string): Exact target element reference from the page snapshot
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_hover**
- - Title: Hover mouse
- - Description: Hover over element on page
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `ref` (string): Exact target element reference from the page snapshot
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_type**
- - Title: Type text
- - Description: Type text into editable element
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `ref` (string): Exact target element reference from the page snapshot
- - `text` (string): Text to type into the element
- - `submit` (boolean, optional): Whether to submit entered text (press Enter after)
- - `slowly` (boolean, optional): Whether to type one character at a time. Useful for triggering key handlers in the page. By default entire text is filled in at once.
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_select_option**
- - Title: Select option
- - Description: Select an option in a dropdown
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `ref` (string): Exact target element reference from the page snapshot
- - `values` (array): Array of values to select in the dropdown. This can be a single value or multiple values.
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_press_key**
- - Title: Press a key
- - Description: Press a key on the keyboard
- - Parameters:
- - `key` (string): Name of the key to press or a character to generate, such as `ArrowLeft` or `a`
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_wait_for**
- - Title: Wait for
- - Description: Wait for text to appear or disappear or a specified time to pass
- - Parameters:
- - `time` (number, optional): The time to wait in seconds
- - `text` (string, optional): The text to wait for
- - `textGone` (string, optional): The text to wait for to disappear
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_file_upload**
- - Title: Upload files
- - Description: Upload one or multiple files
- - Parameters:
- - `paths` (array): The absolute paths to the files to upload. Can be a single file or multiple files.
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_handle_dialog**
- - Title: Handle a dialog
- - Description: Handle a dialog
- - Parameters:
- - `accept` (boolean): Whether to accept the dialog.
- - `promptText` (string, optional): The text of the prompt in case of a prompt dialog.
- - Read-only: **false**
- </details>
- <details>
- <summary><b>Navigation</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_navigate**
- - Title: Navigate to a URL
- - Description: Navigate to a URL
- - Parameters:
- - `url` (string): The URL to navigate to
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_navigate_back**
- - Title: Go back
- - Description: Go back to the previous page
- - Parameters: None
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_navigate_forward**
- - Title: Go forward
- - Description: Go forward to the next page
- - Parameters: None
- - Read-only: **true**
- </details>
- <details>
- <summary><b>Resources</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_take_screenshot**
- - Title: Take a screenshot
- - Description: Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.
- - Parameters:
- - `raw` (boolean, optional): Whether to return without compression (in PNG format). Default is false, which returns a JPEG image.
- - `filename` (string, optional): File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified.
- - `element` (string, optional): Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too.
- - `ref` (string, optional): Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too.
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_pdf_save**
- - Title: Save as PDF
- - Description: Save page as PDF
- - Parameters:
- - `filename` (string, optional): File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified.
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_network_requests**
- - Title: List network requests
- - Description: Returns all network requests since loading the page
- - Parameters: None
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_console_messages**
- - Title: Get console messages
- - Description: Returns all console messages
- - Parameters: None
- - Read-only: **true**
- </details>
- <details>
- <summary><b>Utilities</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_install**
- - Title: Install the browser specified in the config
- - Description: Install the browser specified in the config. Call this if you get an error about the browser not being installed.
- - Parameters: None
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_close**
- - Title: Close browser
- - Description: Close the page
- - Parameters: None
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_resize**
- - Title: Resize browser window
- - Description: Resize the browser window
- - Parameters:
- - `width` (number): Width of the browser window
- - `height` (number): Height of the browser window
- - Read-only: **true**
- </details>
- <details>
- <summary><b>Tabs</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_tab_list**
- - Title: List tabs
- - Description: List browser tabs
- - Parameters: None
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_tab_new**
- - Title: Open a new tab
- - Description: Open a new tab
- - Parameters:
- - `url` (string, optional): The URL to navigate to in the new tab. If not provided, the new tab will be blank.
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_tab_select**
- - Title: Select a tab
- - Description: Select a tab by index
- - Parameters:
- - `index` (number): The index of the tab to select
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_tab_close**
- - Title: Close a tab
- - Description: Close a tab
- - Parameters:
- - `index` (number, optional): The index of the tab to close. Closes current tab if not provided.
- - Read-only: **false**
- </details>
- <details>
- <summary><b>Testing</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_generate_playwright_test**
- - Title: Generate a Playwright test
- - Description: Generate a Playwright test for given scenario
- - Parameters:
- - `name` (string): The name of the test
- - `description` (string): The description of the test
- - `steps` (array): The steps of the test
- - Read-only: **true**
- </details>
- <details>
- <summary><b>Vision mode</b></summary>
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_screen_capture**
- - Title: Take a screenshot
- - Description: Take a screenshot of the current page
- - Parameters: None
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_screen_move_mouse**
- - Title: Move mouse
- - Description: Move mouse to a given position
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `x` (number): X coordinate
- - `y` (number): Y coordinate
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_screen_click**
- - Title: Click
- - Description: Click left mouse button
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `x` (number): X coordinate
- - `y` (number): Y coordinate
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_screen_drag**
- - Title: Drag mouse
- - Description: Drag left mouse button
- - Parameters:
- - `element` (string): Human-readable element description used to obtain permission to interact with the element
- - `startX` (number): Start X coordinate
- - `startY` (number): Start Y coordinate
- - `endX` (number): End X coordinate
- - `endY` (number): End Y coordinate
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_screen_type**
- - Title: Type text
- - Description: Type text
- - Parameters:
- - `text` (string): Text to type into the element
- - `submit` (boolean, optional): Whether to submit entered text (press Enter after)
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_press_key**
- - Title: Press a key
- - Description: Press a key on the keyboard
- - Parameters:
- - `key` (string): Name of the key to press or a character to generate, such as `ArrowLeft` or `a`
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_wait_for**
- - Title: Wait for
- - Description: Wait for text to appear or disappear or a specified time to pass
- - Parameters:
- - `time` (number, optional): The time to wait in seconds
- - `text` (string, optional): The text to wait for
- - `textGone` (string, optional): The text to wait for to disappear
- - Read-only: **true**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_file_upload**
- - Title: Upload files
- - Description: Upload one or multiple files
- - Parameters:
- - `paths` (array): The absolute paths to the files to upload. Can be a single file or multiple files.
- - Read-only: **false**
- <!-- NOTE: This has been generated via update-readme.js -->
- - **browser_handle_dialog**
- - Title: Handle a dialog
- - Description: Handle a dialog
- - Parameters:
- - `accept` (boolean): Whether to accept the dialog.
- - `promptText` (string, optional): The text of the prompt in case of a prompt dialog.
- - Read-only: **false**
- </details>
- <!--- End of tools generated section -->
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.