Better AI Browser Utilities (BABU)

Control MCP eficiente en tokens para la sesión de Chrome que ya usas: pestañas, cookies, inicios de sesión y todo lo demás. BABU conecta cualquier agente de codificación compatible con MCP a una extensión local de Chrome en lugar de lanzar un perfil de automatización separado.

Por qué BABU

• Cuatro esquemas MCP compactos por defecto en lugar de veinte herramientas de navegador repetitivas.

• Divulgación progresiva: browser_read devuelve texto limitado y controles compactos; browser_help revela los detalles de los comandos solo cuando se solicitan.

• Acciones rápidas: browser_do despacha navegación, clics, escritura, teclas, desplazamiento, esperas, capturas de pantalla, JavaScript y cargas de archivos en bucle local.

• Estado real del navegador: usa tus pestañas de Chrome existentes y sesiones autenticadas.

• Portátil: instala directamente desde GitHub con uvx; cada cliente documentado usa stdio MCP estándar.

• Local primero: el único listener de red se vincula a 127.0.0.1; el WebSocket de la extensión requiere un token de emparejamiento generado.

Los esquemas MCP v2 publicados miden 567 tokens en modo compacto frente a 2.219 para la superficie heredada de veinte herramientas: 74,45 % menos contexto de esquema por turno de modelo (o200k_base, JSON canónico, excluyendo el marco del cliente).

Arquitectura

MCP client
   |  stdio (client-owned subprocess)
   v
BABU Python bridge
   |  authenticated WebSocket ws://127.0.0.1:8765
   v
BABU Chrome extension (MV3) -> your real Chrome tabs

Instalación

Requisitos previos: uv y Chrome 116 o superior.

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup

El comando exporta la extensión empaquetada a ~/.babu/extension, crea ~/.babu/token e imprime el token una vez para el emparejamiento.

En Chrome:

1. Abre chrome://extensions.

2. Activa el modo de desarrollador.

3. Selecciona Cargar descomprimida y elige el directorio de extensión impreso.

4. Abre la extensión BABU, pega el token de emparejamiento y selecciona Guardar.

Chrome estable ya no acepta la instalación automatizada con --load-extension, por lo que se requiere la carga manual única.

Añadir BABU a un cliente MCP

Usa esta definición de lanzamiento stdio:

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0",
    "babu",
    "mcp"
  ]
}

Los comandos y archivos de configuración exactos para Hermes, Codex, Claude Code, Cursor, VS Code, Zed, ZCode, Gemini CLI, OpenCode, Cline, Windsurf, Pi y Agent Prime están en docs/CLIENTS.md.

Solo un proceso BABU puede poseer el puerto WebSocket 8765 a la vez. Cierra otro harness habilitado para BABU antes de iniciar uno nuevo.

Herramientas MCP

Comandos de browser_do:

list_tabs, get_active_tab, open_tab, close_tab, activate_tab, navigate,
get_state, snapshot, click, hover, type, select, press, scroll, extract_text, screenshot,
eval, upload_files, wait_for, back, forward, reload

Flujo recomendado:

1. Llama a browser_read con una query relevante.

2. Pasa el índice de elemento devuelto a browser_do con click o type.

3. Vuelve a leer después de la navegación o cambios importantes en el DOM porque los índices son locales al documento.

4. Usa browser_help solo cuando los parámetros de un comando no estén claros.

Las capturas de pantalla se guardan en el directorio temporal del sistema por defecto; los bytes de imagen base64 se omiten del contexto del modelo a menos que include_data_url=true sea explícito.

Utilidades CLI

babu setup [--force]            # export/update extension and create token
babu token                      # print the current pairing token
babu mcp                        # stdio MCP server, compact profile
babu relay list_tabs            # direct browser command without an MCP client
babu relay navigate '{"url":"https://example.com"}'

babu relay es útil para harnesses mínimos que prefieren herramientas CLI sobre MCP.

Perfiles de herramientas

• compact (por defecto): las cuatro herramientas anteriores.

• legacy: veinte herramientas directas de navegador para clientes que prefieren un esquema por acción.

• all: ambas superficies.

Selecciona un perfil con --tool-profile compact|legacy|all o BABU_TOOL_PROFILE.

Seguridad

BABU controla el perfil de navegador con sesión iniciada, así que trátalo como una herramienta local potente.

• El listener de WebSocket se vincula solo a 127.0.0.1; MCP viaja por stdio.

• Se validan los orígenes de la extensión de Chrome y los roles de cliente.

• El canal de extensión a puente usa un token de 256 bits almacenado en ~/.babu/token.

• El popup de la extensión puede deshabilitar todo el control inmediatamente.

• Los campos de contraseña, OTP y pago se redactan de las lecturas rutinarias.

• browser_eval ejecuta JavaScript en el mundo principal de la página por diseño.

• La carga de archivos acepta solo URLs HTTP(S) de bucle local directas y limitadas sin credenciales.

Revisa cada invocación de herramienta MCP y usa los controles de aprobación de cada cliente.

Limitaciones

• Las páginas internas de Chrome, la Web Store, el visor de PDF, las pestañas no cargadas y los controles dentro de iframes o shadow roots no se pueden controlar.

• Una CSP estricta de la página puede bloquear browser_eval; las herramientas de lectura/clic/escritura del DOM siguen funcionando.

• browser_press admite Enter, Tab y Escape sintético; usa browser_type para texto.

• La extensión descomprimida debe recargarse desde chrome://extensions después de una actualización.

• El servidor es de un solo cliente y una sola extensión de navegador por diseño.

Actualización

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup --force

Recarga BABU en chrome://extensions y luego reinicia el cliente MCP. Cambia la etiqueta Git en la configuración de tu cliente al adoptar una versión más reciente.

Licencia

MIT