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

Configuración

Instalar dependencias

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

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

2. Distribuciones de paquetes de compilación:

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

3. Publicar en PyPI:

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:

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