Servidor MCP Patchright Lite

Un servidor optimizado de Protocolo de Contexto de Modelo (MCP) que integra el SDK de Node.js de Patchright para proporcionar capacidades de automatización de navegadores ocultos a los modelos de IA. Este servidor ligero se centra en la funcionalidad esencial para facilitar el uso de modelos de IA más simples.

¿Qué es Patchright?

Patchright es una versión no detectada del framework de pruebas y automatización Playwright. Está diseñado como un reemplazo directo de Playwright, pero con funciones avanzadas de sigilo para evitar la detección de sistemas antibots. Patchright parchea diversas técnicas de detección, incluyendo:

Fuga de Runtime.enable
Fuga de Console.enable
Fugas de indicadores de comando
Puntos de detección generales
Interacciones cerradas de Shadow Root

Este servidor MCP envuelve la versión Node.js de Patchright para que sus capacidades estén disponibles para los modelos de IA a través de un protocolo simple y estandarizado.

Características

Interfaz sencilla : centrada en la funcionalidad principal con solo 4 herramientas esenciales
Automatización sigilosa : utiliza el modo sigiloso de Patchright para evitar la detección
Estándar MCP : implementa el Protocolo de Contexto de Modelo para una fácil integración de IA
Transporte Stdio : utiliza entrada/salida estándar para una integración perfecta

Prerrequisitos

Node.js 18+
npm o hilo

Instalación

Clonar este repositorio:
git clone https://github.com/yourusername/patchright-lite-mcp-server.git cd patchright-lite-mcp-server
Instalar dependencias:
npm install
Construya el código TypeScript:
npm run build

Uso

Ejecute el servidor con:

npm start

Esto iniciará el servidor con transporte stdio, preparándolo para integrarse con herramientas de IA compatibles con MCP.

Integración con modelos de IA

Escritorio de Claude

Agregue esto a su archivo claude-desktop-config.json :

{
  "mcpServers": {
    "patchright": {
      "command": "node",
      "args": ["path/to/patchright-lite-mcp-server/dist/index.js"]
    }
  }
}

VS Code con GitHub Copilot

Utilice la CLI de VS Code para agregar el servidor MCP:

code --add-mcp '{"name":"patchright","command":"node","args":["path/to/patchright-lite-mcp-server/dist/index.js"]}'

Herramientas disponibles

El servidor proporciona sólo 4 herramientas esenciales:

1. navegar

Inicia un navegador, navega a una URL y extrae contenido.

Tool: browse
Parameters: {
  "url": "https://example.com",
  "headless": true,
  "waitFor": 1000
}

Devoluciones:

Título de la página
Vista previa de texto visible
ID del navegador (para operaciones posteriores)
ID de página (para operaciones posteriores)
Ruta de captura de pantalla

2. interactuar

Realiza una interacción simple en una página.

Tool: interact
Parameters: {
  "browserId": "browser-id-from-browse",
  "pageId": "page-id-from-browse",
  "action": "click", // can be "click", "fill", or "select"
  "selector": "#submit-button",
  "value": "Hello World" // only needed for fill and select
}

Devoluciones:

Resultado de la acción
URL actual
Ruta de captura de pantalla

3. extracto

Extrae contenido específico de la página actual.

Tool: extract
Parameters: {
  "browserId": "browser-id-from-browse",
  "pageId": "page-id-from-browse",
  "type": "text" // can be "text", "html", or "screenshot"
}

Devoluciones:

Contenido extraído según el tipo solicitado

4. cerrar

Cierra un navegador para liberar recursos.

Tool: close
Parameters: {
  "browserId": "browser-id-from-browse"
}

Ejemplo de flujo de uso

Abra un navegador y navegue hasta un sitio:
Tool: browse Parameters: { "url": "https://example.com/login", "headless": false }
Rellene el formulario de inicio de sesión:
Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "fill", "selector": "#username", "value": "user@example.com" }
Introduce la contraseña:
Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "fill", "selector": "#password", "value": "password123" }
Haga clic en el botón de inicio de sesión:
Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "click", "selector": "#login-button" }
Extraer texto para verificar el inicio de sesión:
Tool: extract Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "type": "text" }
Cerrar el navegador:
Tool: close Parameters: { "browserId": "browser-id-from-step-1" }

Consideraciones de seguridad

Este servidor ofrece potentes funciones de automatización. Úselo con responsabilidad y ética.
Evite automatizar acciones que puedan violar los términos de servicio de los sitios web.
Tenga en cuenta los límites de velocidad y no sobrecargue los sitios web con solicitudes.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Patchright-nodejs por Kaliiiiiiiiii-Vinyzu
Protocolo de contexto del modelo por modelcontextprotocol

Uso de Docker

Puedes ejecutar este servidor usando Docker:

docker run -it --rm dylangroos/patchright-mcp

Construyendo la imagen de Docker localmente

Construya la imagen de Docker:

docker build -t patchright-mcp .

Ejecute el contenedor:

docker run -it --rm patchright-mcp

Centro de Docker

La imagen se publica automáticamente en Docker Hub cuando los cambios se fusionan en la rama principal. Puedes encontrar la imagen más reciente en: dylangroos/patchright-mcp

Patchright Lite MCP Server

Integrations