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: playwright-mcp-server

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

2. Distribuciones de paquetes de compilación:

uv build

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

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