Playwright MCP Server

Servidor MCP del dramaturgo

Inglés | Japonés

Este proyecto es un servidor que proporciona la funcionalidad de recuperación de contenido de la página web de Playwright utilizando el Protocolo de Contexto de Modelo (MCP).

Características

• Navegación de página
• Recuperación de contenido de página completa
• Recuperación de contenido visible
• Detección de elementos interactivos
• Simulación del funcionamiento del ratón
• Funcionalidad de eco para pruebas

Instalación

Instalación mediante herrería

Para instalar Playwright MCP Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Uso

Iniciando el servidor

Herramientas MCP

Las siguientes herramientas están disponibles:

1. navigate
   • Navegar a una URL específica
   • Argumentos: { url: string }
   • Devuelve: Resultado de navegación
2. get_all_content
   • Recuperar contenido de toda la página
   • Argumentos: Ninguno
   • Devuelve: Todo el contenido de texto de la página.
3. get_visible_content
   • Recuperar contenido visible actualmente
   • Argumentos: { minVisiblePercentage?: number }
   • Devuelve: Contenido de texto visible
4. get_interactive_elements
   • Obtener información de la posición de los elementos interactivos (botones, enlaces, etc.) en la página
   • Argumentos: Ninguno
   • Devuelve: Información de coordenadas y límites de elementos interactivos
5. move_mouse
   • Mueva el cursor del mouse a las coordenadas especificadas
   • Argumentos: { x: number, y: number }
   • Devuelve: Resultado de la operación
6. mouse_click
   • Ejecutar clic del mouse en las coordenadas especificadas
   • Argumentos: { x: number, y: number, button?: "left" | "right" | "middle", clickCount?: number }
   • Devuelve: resultado de la operación de clic
7. mouse_wheel
   • Ejecutar el desplazamiento con la rueda del ratón
   • Argumentos: { deltaY: number, deltaX?: number }
   • Devuelve: Resultado de la operación de desplazamiento
8. drag_and_drop
   • Ejecutar la operación de arrastrar y soltar
   • Argumentos: { sourceX: number, sourceY: number, targetX: number, targetY: number }
   • Devuelve: Resultado de la operación de arrastrar y soltar
9. echo
   • Herramienta de eco para pruebas
   • Argumentos: { message: string }
   • Devoluciones: Mensaje enviado

Desarrollo

Ejecución de pruebas

Estructura de la prueba

• tools/*.test.ts : Pruebas de función para cada herramienta
• mcp-server.test.ts : pruebas de función del servidor MCP

Características de implementación

1. Recuperación de contenido
   • Recuperación de contenido de página completa
   • Recuperación de solo contenido visible
   • Análisis HTML adecuado
2. Interacción
   • Detección y recuperación de información de posición de elementos interactivos
   • Simulación del funcionamiento del ratón (movimiento, clics, desplazamiento)
   • Soporte para arrastrar y soltar
3. Manejo de errores
   • Manejo adecuado de errores de navegación
   • Procesamiento de tiempo de espera
   • Detección de URL no válida
4. Flexibilidad de configuración
   • Selección de modo sin cabeza/con cabeza
   • Agente de usuario personalizado
   • Configuración del tamaño de la ventana gráfica

Notas importantes

• Asegúrese de que las variables de entorno necesarias estén configuradas antes de usar el servidor MCP
• Siga los términos de servicio de los sitios web de destino al recuperar el contenido de la página web
• Mantenga intervalos adecuados al enviar múltiples solicitudes
• Al realizar operaciones con el mouse, mantenga intervalos apropiados ya que simulan interacciones reales del usuario.

Licencia

ISC