Servidor MCP de Chrome

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona un control detallado sobre una instancia del navegador Chrome a través del Protocolo de herramientas de desarrollo de Chrome (CDP).

Prerrequisitos

• Bun (recomendado) o Node.js (v14 o superior)

• Navegador Chrome con depuración remota habilitada

Related MCP server: MCP Browser Server

Configuración

Instalación de Bun

1. Instalar Bun (si aún no está instalado):

# macOS, Linux, or WSL
curl -fsSL https://bun.sh/install | bash

# Windows (using PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

# Alternatively, using npm
npm install -g bun

2. Inicie Chrome con la depuración remota habilitada:

   Puede utilizar el script incluido que detecta automáticamente su sistema operativo e inicia Chrome con el comando correcto:

   # Make the script executable
   chmod +x start-chrome.sh
   
   # Run the script
   ./start-chrome.sh

   O inicie Chrome manualmente con depuración remota:

   # macOS
   /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222
   
   # Windows
   start chrome --remote-debugging-port=9222
   
   # Linux
   google-chrome --remote-debugging-port=9222

3. Instalar dependencias:

bun install

4. Iniciar el servidor:

bun start

Para desarrollo con recarga en caliente:

bun dev

El servidor se iniciará en el puerto 3000 de forma predeterminada. Puede cambiarlo configurando la variable de entorno PORT .

Configuración de Roo Code para utilizar este servidor MCP

Para utilizar este servidor Chrome MCP con Roo Code:

1. Abrir la configuración del código Roo

2. Navegue hasta el archivo de configuración de MCP en:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

   • Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

   • Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

3. Agregue la siguiente configuración al objeto mcpServers :

{
  "mcpServers": {
    "chrome-control": {
      "url": "http://localhost:3000/sse-cursor",
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

4. Guarde el archivo y reinicie Roo Code para aplicar los cambios.

5. Ahora puedes usar las herramientas MCP de Chrome en Roo Code para controlar el navegador.

Herramientas disponibles

El servidor proporciona las siguientes herramientas para el control del navegador:

navegar por

Navegar a una URL específica.

Parámetros:

• url (cadena): La URL a la que navegar

hacer clic

Haga clic en coordenadas específicas.

Parámetros:

• x (número): coordenada X

• y (número): coordenada Y

tipo

Escriba texto en el foco actual.

Parámetros:

• text (cadena): Texto a escribir

clickElement

Haga clic en un elemento por su índice en la información de la página.

Parámetros:

• selector (cadena): índice del elemento (por ejemplo, "0" para el primer elemento)

obtenerTexto

Obtenga el contenido de texto de un elemento mediante un selector CSS.

Parámetros:

• selector (cadena): selector CSS para encontrar el elemento

obtener información de la página

Obtenga información semántica sobre la página, incluidos elementos interactivos y nodos de texto.

obtenerEstadoDePágina

Obtener el estado actual de la página, incluida la URL, el título, la posición de desplazamiento y el tamaño de la ventana gráfica.

Uso

El servidor implementa el Protocolo de Contexto de Modelo con transporte SSE. Conéctese al servidor en:

• Punto final de SSE: http://localhost:3000/sse-cursor

• Punto final de mensajes: http://localhost:3000/message?sessionId=...

Al utilizarlo con Roo Code, la configuración en el archivo de configuración MCP manejará la conexión automáticamente.

Desarrollo

Para ejecutar el servidor en modo de desarrollo con recarga en caliente:

bun dev

Esto utiliza el modo de vigilancia integrado de Bun para reiniciar automáticamente el servidor cuando los archivos cambian.

Licencia

Instituto Tecnológico de Massachusetts (MIT)