Browser Navigator MCP

Un servidor MCP (Model Context Protocol) que brinda a los asistentes de IA control total sobre el navegador Brave mediante CDP (Chrome DevTools Protocol). Diseñado para investigaciones OSINT, extracción de datos en redes sociales y automatización web en general.

Se conecta a tu instancia existente de Brave (o inicia una nueva) sin tocar tus pestañas: se conecta al navegador, no a una copia clonada.

Características

• 🧭 Control total del navegador — navegar, hacer clic, escribir, desplazarse, pasar el cursor, capturas de pantalla, exportar PDF

• 🪟 Gestión de ventanas y pestañas — listar, abrir, cambiar y cerrar ventanas/pestañas

• 🔐 Detección de CAPTCHA — detecta automáticamente reCAPTCHA, hCaptcha, Cloudflare Turnstile y otros desafíos, y espera a que el humano los resuelva

• 🍪 Persistencia de sesión — guardar/cargar cookies para mantener las sesiones iniciadas entre ejecuciones

• 🎥 Control de video — reproducir/pausar/buscar/ajustar volumen en cualquier reproductor HTML5 (YouTube, etc.)

• 🔍 Búsqueda social — búsqueda con una sola herramienta en Google, X/Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube

• 🔧 JavaScript arbitrario — execute_js para cualquier otra cosa (con un indicador de confirmación explícito)

• 🏥 Verificación de salud — confirma el estado de la conexión entre el servidor y el navegador

Requisitos

• Node.js 20+

• Navegador Brave (instalado en una ruta estándar, o especifícalo con BRAVE_PATH)

• No se necesita descargar Playwright: el servidor controla Brave directamente a través de CDP

Instalación

git clone <your-repo-url>
cd brave-browser-mcp
npm install

Inicio rápido

1. Inicia Brave con el puerto de depuración

./launch-brave.sh

Esto inicia Brave con --remote-debugging-port=9222. Nunca mata una instancia existente de Brave — si el puerto 9222 ya está en uso, lo deja intacto.

Alternativamente, inicia Brave manualmente con brave --remote-debugging-port=9222. Si Brave ya está ejecutándose sin un puerto de depuración, el MCP te pedirá que lo cierres y lo reintentes — no matará tu navegador en ejecución.

2. Ejecuta el servidor

node index.js

El servidor habla MCP a través de stdio. connect_brave se conecta automáticamente a la instancia de Brave en ejecución.

3. Regístralo como servidor MCP

Para opencode, agrégalo a opencode.json:

{
  "mcp": {
    "browser-navigator": {
      "type": "local",
      "command": ["node", "index.js"],
      "cwd": "/absolute/path/to/brave-browser-mcp",
      "enabled": true
    }
  }
}

Para Claude Desktop, agrégalo a claude_desktop_config.json:

{
  "mcpServers": {
    "browser-navigator": {
      "command": "node",
      "args": ["/absolute/path/to/brave-browser-mcp/index.js"]
    }
  }
}

Herramientas

Manejo de CAPTCHA

Los CAPTCHAs se detectan automáticamente después de navigate / navigate_history y se informan en get_page_info. Cuando se encuentra un CAPTCHA sin resolver, la automatización se pausa y le pide al usuario que lo resuelva en el navegador — esta herramienta no puede (y no lo hará) evadirlos.

Tipos detectados: reCAPTCHA, hCaptcha, Cloudflare Turnstile, Cloudflare Challenge.

Notas de seguridad

• execute_js requiere confirm=true y está limitado a 5000 caracteres / 50KB de salida.

• Las rutas de capturas de pantalla y cookies están saneadas contra el traversal de rutas.

• Las cookies se almacenan con permisos 0o600, los directorios con 0o700.

• El servidor nunca mata un navegador que no haya iniciado él mismo.

• Consulta AUDIT.md para la auditoría completa de seguridad y calidad del código.

Pruebas

La suite controla el servidor a través del protocolo MCP stdio real (requiere Brave ejecutándose en el puerto 9222):

node test.cjs

53 aserciones que cubren navegación, CAPTCHA, pestañas, ventanas, capturas de pantalla, cookies, video y endurecimiento de seguridad.

Licencia

PolyForm Noncommercial 1.0.0 — consulta LICENSE.

Uso gratuito para cualquier propósito no comercial (personal, investigación, educación, pasatiempos, organizaciones benéficas, gobiernos). Para uso comercial, contacta al autor primero — por favor comunícate antes de usar este proyecto comercialmente.