Playwright SSE MCP Server

dramaturgo-sse-mcp-servidor

Este es un servicio que proporciona Playwright como un servidor MCP (Protocolo de contexto de modelo). Al utilizar este servidor, puede utilizar las funciones de Playwright desde los clientes MCP.

Prerrequisitos

• Docker instalado
• Docker-compose instalado
• Se ha creado una red Docker llamada mcp-network.

Si la red mcp no existe, puedes crearla con el siguiente comando:

Cómo configurar y empezar

1. Clonar o descargar el repositorio
2. Ejecute el siguiente comando en el directorio raíz del proyecto:

Esto iniciará el servidor en el puerto predeterminado 3002. Una vez completado el arranque, verá el siguiente mensaje:

Configuración de un puerto personalizado

Si desea iniciar el servidor en un puerto distinto del puerto predeterminado (3002), configure PORT :

Esto iniciará el servidor en el puerto que especifique (4000 en este ejemplo):

Cómo utilizar

Conexiones desde contenedores que participan en la misma red mcp

Desde otros contenedores que participan en la misma red mcp, puede conectarse al servidor con la siguiente URL (donde PORT es el puerto de inicio del servidor):

Si está utilizando los puertos predeterminados:

Esto le permite aprovechar la funcionalidad MCP de Playwright.

Conexión desde el lado del host

Desde la máquina host, puede conectarse al servidor con la siguiente URL (donde PORT es el puerto de ejecución del servidor):

Si está utilizando los puertos predeterminados:

Conectando desde Roo Code

Servidores MCP -> Editar configuración de MCP -> Complete lo siguiente ( PORT es el puerto de inicio del servidor):

Si está utilizando los puertos predeterminados:

*A partir del 27 de marzo de 2025, Cline no es compatible con SSE y no se puede utilizar.

Conexión desde Roo Code en un entorno de contenedor

Desde un contenedor de código Roo que se ejecuta en la misma red Docker, configure el MCP de la siguiente manera:

Ejemplo de configuración de docker-compose.yml :

Con esta configuración, puede conectarse al contenedor playwright-sse-mcp-server desde el contenedor Roo Code y utilizar la función de operación del navegador. Al utilizar el nombre del contenedor ( playwright-sse-mcp-server ) como nombre de host, es posible la resolución de nombres dentro de la red Docker.

Conexión desde Roo Code en un entorno de contenedor de desarrollo (a través del host)

Si desea ejecutar Roo Code en un contenedor de desarrollo y conectarse a este servidor MCP a través de su máquina host sin unirse mcp-network , configure el MCP de la siguiente manera:

Para Docker Desktop (Mac/Windows):

Para Linux (ejemplo: usando la IP de la puerta de enlace del puente):

Nota:

• Reemplace <PORT> con el número de puerto que su servidor MCP expone en su host (predeterminado: 3002).
• Para Linux, reemplace 172.17.0.1 con su dirección IP de host real o la dirección IP de puerta de enlace de la red del puente Docker. Consulte la sección Conectarse desde un contenedor de desarrollo (a través del host) para obtener más información.

Conexión desde un contenedor de desarrollo (a través del host)

Si necesita acceder a este servidor MCP desde un contenedor de desarrollo que no es parte de mcp-network (por ejemplo, cuando es difícil cambiar la red debido a un proyecto existente), puede conectarse a través de la máquina host.

Con este método, se especifica la dirección IP o el nombre DNS especial de la "máquina host" desde la perspectiva de su contenedor de desarrollo y el puerto que el servidor MCP expone en el host (establecido por ports en compose.yml , el valor predeterminado es 3002).

URL de destino:

Reemplace <PORT> con el número de puerto en el que se ejecuta el servidor MCP.

Cómo determinar <host_ip_or_dns_name> :

• Docker Desktop (Mac/Windows): puede utilizar el nombre DNS especial host.docker.internal .
  • Ejemplo: http://host.docker.internal:3002/sse
• Linux:
  • Dirección IP del host: utilice la dirección IP asignada a una interfaz de red en la máquina host (por ejemplo, la que se encuentra con los comandos ifconfig o ip addr ).
    • Ejemplo: http://192.168.1.10:3002/sse (la dirección IP puede variar según su entorno)
  • Puerta de enlace de red del puente Docker: puede utilizar la dirección IP de la puerta de enlace de la red del puente predeterminado de Docker ( bridge ), que normalmente es 172.17.0.1 . Puedes comprobarlo con docker network inspect bridge .
    • Ejemplo: http://172.17.0.1:3002/sse

Tenga en cuenta:

• Dependiendo de la configuración del firewall de su host, es posible que su contenedor de desarrollo no tenga permitido acceder a los puertos del host.
• Verifique el número de puerto a utilizar con docker compose ps o en compose.yml .

Uso conveniente

Es tedioso ir al directorio del proyecto y ejecutar el comando docker compose cada vez. Puede iniciar y detener fácilmente su servidor desde cualquier lugar utilizando los siguientes métodos:

Método de script de shell

Este proyecto contiene scripts de shell para iniciar y detener el servidor y ver registros fácilmente.

1. Clonar o descargar el proyecto:

2. Agregue la siguiente línea a .bashrc (o .zshrc o cualquier archivo de configuración de shell que esté usando) para incluir el script de shell:

3. Reinicie su shell o recargue el archivo de configuración:

Ahora puedes usar el siguiente comando desde cualquier lugar:

Uso básico

• playwright-mcp-start : inicia el servidor con la configuración predeterminada (puerto 3002, sin reinicio)
• playwright-mcp-stop - Detener el servidor
• playwright-mcp-logs - Ver registros del servidor

Uso del modo persistente

El modo persistente garantizará que el servidor se inicie automáticamente al reiniciar el sistema:

Usando un puerto personalizado

Combinando el modo de persistencia con puertos personalizados

Cómo especificar una política de reinicio específica

Obtener ayuda

Este método es más fácil de usar porque le brinda más flexibilidad para cambiar la configuración mediante las opciones de bandera. Además, al separar los scripts de shell en archivos separados, su archivo .bashrc será más simple y fácil de mantener.

Personalización del script de shell

El script de shell se encuentra en scripts/playwright-mcp.sh . Puede editar este archivo para personalizarlo según sus necesidades.

variables ambientales

El script de shell utiliza las siguientes variables de entorno:

• PLAYWRIGHT_MCP_HOME : El directorio de instalación del proyecto. Si no se configura, se detectará automáticamente desde la ubicación del script.

Por ejemplo, puede especificar una ruta personalizada configurando una variable de entorno como esta:

Notas

• Este servidor ejecuta Playwright en modo sin cabeza
• El servidor se comunica con el cliente MCP mediante SSE (eventos enviados por el servidor)