remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides containerized environment for running the Playwright MCP server, allowing integration with other services through Docker networks and environment variables for deployment flexibility.
Offers specific configuration options for running the Playwright MCP server in Linux environments, including special network addressing considerations.
Provides persistence options for the server, allowing automatic startup on system reboot through a dedicated persistent mode.
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
- Clonar o descargar el repositorio
- 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.1con 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
- Ejemplo:
- 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
ifconfigoip addr).- Ejemplo:
http://192.168.1.10:3002/sse(la dirección IP puede variar según su entorno)
- Ejemplo:
- 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 es172.17.0.1. Puedes comprobarlo condocker network inspect bridge.- Ejemplo:
http://172.17.0.1:3002/sse
- Ejemplo:
- 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
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 pso encompose.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.
- Clonar o descargar el proyecto:
- Agregue la siguiente línea a
.bashrc(o.zshrco cualquier archivo de configuración de shell que esté usando) para incluir el script de shell:
- 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 servidorplaywright-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)
This server cannot be installed
Un servicio que proporciona la funcionalidad de automatización del navegador Playwright a través del Protocolo de Contexto de Modelo (MCP), lo que permite a los clientes utilizar las funciones de Playwright a través de conexiones SSE.