Agentic Tab Organizer MCP

Conecta cualquier agente de IA compatible con MCP a las pestañas en vivo de un navegador basado en Chromium. El agente puede listar pestañas, leer el contenido de la página seleccionada, previsualizar un plan de organización y consolidar las pestañas retenidas en una única ventana sin duplicados.

El organizador no contiene un modelo de IA y no requiere una clave de API de IA. Tu cliente MCP utiliza su autenticación de modelo existente. Las conexiones Stdio y HTTP independientes usan un token de emparejamiento local que muestra la extensión; este token nunca sale de tu máquina.

Capacidades

• Listar pestañas de cada ventana normal del navegador con títulos, URLs, grupos y estado de pestaña

• Extraer texto legible limitado de pestañas HTTP y HTTPS seleccionadas

• Cerrar pestañas por dominio exacto o IDs de pestaña explícitos, con coincidencia de subdominios opcional

• Deduplicar URLs normalizadas exactas conservando la copia preferida

• Conservar pestañas fijadas durante la organización y cierres arbitrarios a menos que se permita explícitamente

• Previsualizar y validar categorías ordenadas antes de cambiar el navegador

• Crear una ventana de destino con grupos de pestañas visibles o una tira plana de pestañas de izquierda a derecha

• Ordenar y verificar las pestañas retenidas antes de cerrar duplicados

• Conectar mediante MCP stdio estándar o HTTP Streamable local

Related MCP server: ChromeWire MCP

Requisitos

• Brave Browser, Google Chrome u otro navegador Chromium compatible

• Node.js 20 o más reciente

• Un agente compatible con MCP como OpenCode, Claude Desktop, Cursor u otro cliente MCP

El desarrollo y la verificación con navegador real se realizan principalmente con Brave. Chrome y los navegadores Chromium relacionados usan las mismas APIs de extensión y se espera que funcionen, pero actualmente no reciben la misma cobertura de extremo a extremo.

Compilación

npx pnpm@11.24.0 install
npx pnpm@11.24.0 run build

Abre brave://extensions en Brave o chrome://extensions en Chrome, activa Modo de desarrollador, selecciona Cargar descomprimida y elige el directorio dist de este repositorio.

Abre la ventana emergente de la extensión y copia su token de emparejamiento local.

Conectar un agente

Stdio

Stdio es la opción más sencilla. Configura tu cliente MCP con la ruta absoluta a dist-node/mcp-stdio.cjs:

{
  "mcpServers": {
    "agentic-tabs": {
      "command": "/absolute/path/to/agentic-tab-organizer/dist-node/mcp-stdio.cjs",
      "env": {
        "AGENTIC_TABS_BRIDGE_TOKEN": "TOKEN_FROM_EXTENSION_POPUP"
      }
    }
  }
}

El proceso del agente abre un puente del navegador solo para localhost. La extensión se reconecta automáticamente.

HTTP Streamable

Inicia el servidor local persistente:

AGENTIC_TABS_BRIDGE_TOKEN="TOKEN_FROM_EXTENSION_POPUP" npx pnpm@11.24.0 run mcp:http

Configura el cliente MCP para usar:

http://127.0.0.1:32145/mcp

No ejecutes los modos stdio y HTTP simultáneamente porque ambos usan el mismo puerto del puente local del navegador.

Mensajería nativa

La mensajería nativa es opcional en macOS y Linux. El instalador registra el mismo host para Google Chrome, Brave y Chromium:

npx pnpm@11.24.0 run install:host

Después de recargar la extensión, el navegador inicia automáticamente el host MCP HTTP local. Conecta un cliente MCP HTTP a http://127.0.0.1:32145/mcp.

Flujo de trabajo del agente

El MCP expone cinco herramientas:

Ejemplo de solicitud:

Inspecciona todas las pestañas del navegador. Resume las páginas ambiguas según sea necesario, agrupa en Trabajo, Lectura, Social, Desarrollo y Otros, y luego previsualiza el plan. Tras la aprobación, consolida en una única ventana sin duplicados.

Cierra todas las pestañas abiertas de amazon.nl.

browser_plan_organization acepta createGroups, que por defecto es true. Establécelo en false para usar el orden de categorías solo para la colocación de izquierda a derecha: las pestañas fijadas permanecen primero, seguidas de cada categoría en el orden proporcionado, sin grupos de pestañas visibles en la ventana de destino.

Consolida todas las ventanas en una única ventana sin duplicados. No crees grupos de pestañas; organiza las categorías de izquierda a derecha.

Seguridad y privacidad

• La planificación no modifica el navegador.

• La aplicación se aborta si las pestañas, URLs, ventanas, estado de fijación, orden o grupos cambian después de la planificación.

• Las pestañas duplicadas se cierran solo después de que las pestañas retenidas se verifiquen en la ventana de destino.

• browser_close_tabs admite un dominio exacto como amazon.nl o IDs explícitos devueltos por browser_list_tabs; el www inicial se normaliza y los subdominios requieren aceptación explícita.

• Antes de cerrar cualquier cosa, la extensión verifica que cada pestaña seleccionada aún tenga la URL observada por el servidor MCP. Si una pestaña navegó mientras tanto, toda la operación de cierre se aborta.

• Las pestañas fijadas se omiten por defecto y aparecen en skippedTabs; cerrarlas requiere allowPinned: true.

• Las operaciones de organización y cierre arbitrario comparten un bloqueo de mutación, lo que impide que cambien el navegador simultáneamente.

• El acceso de incógnito está deshabilitado.

• El puente WebSocket local se vincula solo a 127.0.0.1 y acepta el origen fijo de la extensión.

• La extensión y el proceso MCP local se autentican mutuamente con HMAC de desafío-respuesta; el token de emparejamiento nunca se transmite.

• El contenido de la página se devuelve solo cuando un agente llama a browser_get_tab_content.

• Las páginas protegidas del navegador como brave:// y chrome:// no se pueden leer, pero aún se pueden listar y mover.

• El contenido devuelto a un agente puede enviarse al proveedor de modelos configurado de ese agente.

Desarrollo

npx pnpm@11.24.0 run typecheck
npx pnpm@11.24.0 run test:unit
npx pnpm@11.24.0 run test:integration
npx pnpm@11.24.0 run test:e2e
npx pnpm@11.24.0 run build

El conjunto de pruebas de extremo a extremo lanza Brave con un perfil desechable y nunca toca el perfil normal del navegador del usuario. Brave es el navegador principal verificado; la compatibilidad con Chrome se deriva de las APIs de extensión compartidas de Chromium y de las rutas de integración neutrales al navegador.