Playwright MCP
dramaturgo-mcp
Envoltorio de Playwright para MCP (Protocolo de Contexto de Modelo). Este servidor permite a los clientes con tecnología LLM controlar un navegador para tareas de automatización.
Componentes
Recursos
El servidor expone recursos para acceder a las capturas de pantalla del navegador:
URI del recurso de captura de pantalla:
screenshot://{page_id}Los recursos de captura de pantalla están disponibles automáticamente para todas las páginas abiertas
Indicaciones
El servidor proporciona un mensaje para ayudar a los clientes a interpretar las páginas web:
interpret-page: analiza el contenido y la estructura de la página web actualArgumento
page_idopcional para seleccionar qué página interpretarArgumento
focusopcional para centrarse en aspectos específicos (completo, formularios, navegación, texto)Devuelve tanto el análisis de texto como una captura de pantalla de la página.
Herramientas
El servidor implementa un conjunto completo de herramientas de automatización del navegador:
Navegación del navegador
navigate: Ir a una URL específicanew_page: Crea una nueva página del navegador con un ID específicoswitch_page: Cambiar a una página diferente del navegadorget_pages: Lista todas las páginas del navegador disponibles
Interacción de la página
click: haga clic en un elemento usando el selector CSStype: Escribe texto en un elemento de entradawait_for_selector: Esperar a que aparezca un elemento en la página
Extracción de contenido
get_text: Obtener el contenido de texto de un elementoget_page_content: Obtener el HTML de la página completatake_screenshot: Captura el estado visual de la página o elemento
Related MCP server: mcp-browser-automation
Configuración
Instalar dependencias
uv add playwright
playwright install chromiumInicio rápido
Instalar
Escritorio de Claude
En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"playwright-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/shannon/Workspace/artivus/playwright-mcp",
"run",
"playwright-mcp"
]
}
}"mcpServers": {
"playwright-mcp": {
"command": "uvx",
"args": [
"playwright-mcp"
]
}
}Desarrollo
Construcción y publicación
Para preparar el paquete para su distribución:
Sincronizar dependencias y actualizar el archivo de bloqueo:
uv syncDistribuciones de paquetes de compilación:
uv buildEsto creará distribuciones de origen y de rueda en el directorio dist/ .
Publicar en PyPI:
uv publishNota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:
Token:
--tokenoUV_PUBLISH_TOKENO nombre de usuario/contraseña:
--username/UV_PUBLISH_USERNAMEy--password/UV_PUBLISH_PASSWORD
Depuración
Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .
Puede iniciar el Inspector MCP a través de npm con este comando:
npx @modelcontextprotocol/inspector uv --directory /Users/shannon/Workspace/artivus/playwright-mcp run playwright-mcpAl iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.
Available Tools
10 toolsclickC
Click on an element by selector
Inputs: selector (required), page_id.
get_page_contentC
Get the current page HTML content
Inputs: page_id.
get_pagesB
List all available browser pages
Inputs: no named parameters.
get_textC
Get text content from an element
Inputs: selector (required), page_id.
new_pageC
Create a new browser page
Inputs: page_id (required).
switch_pageC
Switch to a different browser page
Inputs: page_id (required).
take_screenshotC
Take a screenshot of the current page
Inputs: page_id, selector.
typeC
Type text into an input element
Inputs: selector (required), text (required), page_id.
wait_for_selectorC
Wait for an element to be visible on the page
Inputs: selector (required), page_id, timeout.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose with no ambiguity. For example, 'click' is for interacting with elements, 'navigate' is for URL changes, and 'take_screenshot' is for capturing visual output. The descriptions make it easy to differentiate between element interaction tools like 'click', 'type', and 'get_text'.
The naming follows a consistent verb-based pattern with clear actions like 'click', 'navigate', and 'type'. There are minor deviations with 'get_page_content' and 'get_text' using 'get_' prefix while others use simple verbs, but overall the naming is highly readable and predictable.
With 10 tools, this is well-scoped for a Playwright automation server. Each tool earns its place by covering essential browser automation tasks like navigation, page management, element interaction, and content retrieval without being overwhelming or redundant.
The toolset provides complete coverage for core browser automation workflows. It includes navigation, page management, element interaction, content retrieval, and screenshot capabilities. There are no obvious gaps—agents can perform full automation sequences from start to finish.
Related MCP Connectors
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
Unofficial Browserless MCP — wraps the Browserless headless-Chromium REST API (browserless.io)
Unofficial Hyperbrowser MCP — wraps the Hyperbrowser AI-agent browsing API (hyperbrowser.ai).…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceExposes Playwright browser automation as MCP tools, enabling AI assistants to control a real browser tab-by-tab for form filling, navigation, and more, while preserving the user's active session.-
- AlicenseBqualityDmaintenanceAn MCP server for generic browser automation using Playwright. Enables MCP clients to navigate pages, inspect elements, execute JavaScript, capture screenshots, and monitor console logs and network traffic via a headless Chromium instance.7ISC
- AlicenseAqualityDmaintenanceEnables MCP clients to automate a real Chrome browser via Playwright, supporting session sharing and tools for navigation, clicking, typing, and more.11108 npm2MIT
- AlicenseCqualityDmaintenanceExposes a remote browser as MCP tools via Playwright, enabling AI agents to navigate and interact with web pages through DOM snapshots, clicks, typing, and form operations.4014 npm14Apache 2.0