Skip to main content
Glama

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 actual

    • Argumento page_id opcional para seleccionar qué página interpretar

    • Argumento focus opcional 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ífica

    • new_page : Crea una nueva página del navegador con un ID específico

    • switch_page : Cambiar a una página diferente del navegador

    • get_pages : Lista todas las páginas del navegador disponibles

  • Interacción de la página

    • click : haga clic en un elemento usando el selector CSS

    • type : Escribe texto en un elemento de entrada

    • wait_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 elemento

    • get_page_content : Obtener el HTML de la página completa

    • take_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 chromium

Inicio 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:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync
  1. Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

  1. Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

  • Token: --token o UV_PUBLISH_TOKEN

  • O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --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-mcp

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Available Tools

10 tools
clickC

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

    B3.2/5.0

    Scored across 10 tools

    Disambiguation5/5

    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'.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes 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.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      7
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Enables MCP clients to automate a real Chrome browser via Playwright, supporting session sharing and tools for navigation, clicking, typing, and more.
      11
      108 npm
      2
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Exposes 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.
      40
      14 npm
      14
      Apache 2.0