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

Configuración

Instalación de Bun

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

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
Instalar dependencias:

bun install

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:

Abrir la configuración del código Roo
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
Agregue la siguiente configuración al objeto mcpServers :

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

Guarde el archivo y reinicie Roo Code para aplicar los cambios.
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)