playwright-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@playwright-server Go to example.com and take a screenshot named example"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
playwright-server MCP server
\A MCP server with playwright tools\
Components
Resources
The server implements a simple note storage system with:
Custom note:// URI scheme for accessing individual notes
Each note resource has a name, description and text/plain mimetype
Prompts
The server provides a single prompt:
summarize-notes: Creates summaries of all stored notes
Optional "style" argument to control detail level (brief/detailed)
Generates prompt combining all current notes with style preference
Tools
The server implements the following tools:
playwright_navigate: Navigates to a specified URL. This operation will automatically create a new session if there is no active session.Requires a
urlargument (string).
playwright_screenshot: Takes a screenshot of the current page or a specific element.Requires a
nameargument (string) for the screenshot file name.Optional
selectorargument (string) to specify a CSS selector for the element to screenshot. If no selector is provided, a full-page screenshot is taken.
playwright_click: Clicks an element on the page using a CSS selector.Requires a
selectorargument (string) to specify the CSS selector for the element to click.
playwright_fill: Fills out an input field.Requires a
selectorargument (string) to specify the CSS selector for the input field.Requires a
valueargument (string) to specify the value to fill.
playwright_evaluate: Executes JavaScript code in the browser console.Requires a
scriptargument (string) to specify the JavaScript code to execute.
playwright_click_text: Clicks an element on the page by its text content.Requires a
textargument (string) to specify the text content of the element to click.
playwright_get_text_content: Get the text content of all visiable elements.playwright_get_html_content: Get the HTML content of the page.Requires a
selectorargument (string) to specify the CSS selector for the element.
Related MCP server: Playwright Plus Python MCP
Configuration
[TODO: Add configuration details specific to your implementation]
Quickstart
Install
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development
Building and Publishing
To prepare the package for distribution:
Sync dependencies and update lockfile:
uv syncBuild package distributions:
uv buildThis will create source and wheel distributions in the dist/ directory.
Publish to PyPI:
uv publishNote: You'll need to set PyPI credentials via environment variables or command flags:
Token:
--tokenorUV_PUBLISH_TOKENOr username/password:
--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm with this command:
npx @modelcontextprotocol/inspector uv --directory C:\Users\YUNYING\Documents\project\python\mcp\playwright-server run playwright-serverUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
Available Tools
8 toolsplaywright_clickC
Click an element on the page using CSS selector
Inputs: selector (required).
playwright_click_textB
Click an element on the page by its text content
Inputs: text (required).
playwright_evaluateC
Execute JavaScript in the browser console
Inputs: script (required).
playwright_fillC
Fill out an input field
Inputs: value (required), selector (required).
playwright_get_html_contentC
Get the HTML content of the page
Inputs: selector (required).
playwright_get_text_contentB
Get the text content of all elements
Inputs: no named parameters.
playwright_screenshotC
Take a screenshot of the current page or a specific element
Inputs: name (required), selector.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 8 tools
Most tools target clearly distinct actions (navigate, screenshot, fill, evaluate, extract text/HTML). The only real overlap is playwright_click vs playwright_click_text, but the descriptions (CSS selector vs text content) make the boundary clear enough.
All tools use a consistent playwright_ prefix followed by a snake_case verb or verb_noun pattern (playwright_get_text_content, playwright_get_html_content). No mixed conventions.
Eight tools is well-scoped for basic browser automation: navigation, interaction, and content extraction. Each tool earns its place without redundancy.
Core navigate/interact/extract workflows are covered, but there are notable gaps: no wait/scroll, no back/forward navigation, no select for dropdowns, no hover or key-press, and no session management/close tool despite auto-creating sessions.
Maintenance
Related MCP Connectors
Playwright browser automation ā navigate, click, fill forms, extract, screenshot ā 17 agent tools.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
A real browser for your agent: screenshots, page checks, Markdown and PDFs.
Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to iā¦
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides browser automation capabilities using Playwright, enabling users to navigate websites, extract content, take screenshots, and interact with web pages through natural language prompts.MIT
- AlicenseBqualityNot gradedmaintenanceEnables browser automation and web scraping through Playwright, supporting navigation, screenshots, element interaction, form filling, JavaScript execution, and content extraction.8Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables browser automation using Playwright, allowing LLMs to interact with web pages, take screenshots, generate test code, scrape web pages, and execute JavaScript in a real browser environment.MIT
- AlicenseNot gradedqualityDmaintenanceProvides browser automation capabilities for AI assistants, enabling web navigation, form filling, and data extraction through Playwright.MIT