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

Related MCP server: Puppeteer MCP Server

Instalación

Instalación mediante herrería

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

npx -y @smithery/cli install @showfive/playwright-mcp-server --client claude

Instalación manual

npm install

Uso

Iniciando el servidor

npm run build
npm start

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

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Generate coverage report
npm run test:coverage

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