WeaveTab MCP V2

El MCP de navegador local de configuración cero para agentes de IA

npm version License: MIT Socket Badge

WeaveTab es un servidor ligero y local del Protocolo de Contexto de Modelo (MCP) que permite a los agentes de IA interactuar sin problemas con navegadores web utilizando el Protocolo de Chrome DevTools (CDP). A diferencia de otras soluciones, WeaveTab es completamente autónomo y de configuración cero. Inicia automáticamente un perfil de navegador en entorno aislado (sandbox) paralelo a tu navegación diaria, lo que significa que nunca tendrás que cerrar tu navegador ni lidiar con puertos de depuración de nuevo.

🌟 Características clave

Navegador autónomo de configuración cero: Se ejecuta completamente en paralelo a tu navegador existente a través de un sandbox aislado. Sin configuración manual de puertos, sin cerrar tu navegador personal.
No requiere extensiones: Se conecta directamente a través de CDP nativo.
Mapa de acciones semántico: weave_read devuelve un mapa semántico DOM analizado y altamente comprimido, lo que reduce significativamente el consumo de tokens.
Acciones en modo francotirador: weave_click y weave_type localizan e interactúan automáticamente con elementos en un solo paso según su intención o etiqueta.
Local y seguro: Sin dependencias en la nube. Limitación de tasa integrada y modo seguro opcional.
Soporte para capturas de pantalla: Usa opcionalmente weave_screenshot para capturar pestañas actuales, o weave_peek para visión dirigida en elementos/canvas específicos.

🚀 Inicio rápido (Integración MCP)

La forma más fácil de usar WeaveTab es a través de npx. Añade lo siguiente a la configuración de tu cliente MCP (por ejemplo, Cursor, OpenCode, Claude Desktop).

Cursor / OpenCode

Añade esto a la configuración de MCP de tu IDE:

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

Claude Desktop

Edita tu claude_desktop_config.json:

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

🛠️ Arsenal de herramientas

WeaveTab expone un rico conjunto de herramientas especializadas para tu IA:

weave_read: Lee la página y devuelve un mapa de acciones semántico.
weave_click: Hace clic en elementos por etiqueta, intención o ID.
weave_type: Escribe texto en formularios de forma segura.
weave_navigate: Navega a una URL objetivo.
weave_scroll: Desplaza hacia arriba, abajo, al principio o al final.
weave_wait: Espera estados específicos (navegación, elemento, estabilidad del DOM).
weave_tabs: Lista las pestañas abiertas o cambia entre ellas.
weave_extract: Extrae contenido visible a texto o JSON.
weave_screenshot: Captura un PNG de la vista actual.
weave_peek: Visión dirigida sobre coordenadas específicas.
weave_key: Presiona teclas físicas y modificadores.
weave_find: Encuentra elementos semánticamente sin extraer la página completa.

🛡️ Seguridad y configuración

WeaveTab respeta tu sistema. Se niega activamente a ejecutarse como root/sudo.

En la primera ejecución, WeaveTab genera un archivo de configuración en ~/.weavetab/config.json:

{
  "safeMode": false,
  "allow": [],
  "rateLimitMs": 1000,
  "preferredBrowser": "google-chrome",
  "persistentProfile": false,
  "screenshot": true,
  "peek": true
}

Características de seguridad

Bloqueo estricto de almacenamiento: Deshabilita scripts que acceden a cookies/localStorage en entornos específicos.
Detección de root: Se cierra si se ejecuta con permisos de root.
Lista blanca de dominios: Evita que tu agente vaya a sitios no confiables cuando safeMode está activo.
Registro de auditoría: Cada acción realizada por la IA se registra limpiamente de forma local en ~/.weavetab/audit.log para tu revisión.

🤝 Contribución

¡Las contribuciones son bienvenidas!

git clone https://github.com/fy2ne/WeaveTab.git
cd WeaveTab
npm install
npm run build

📄 Licencia

Este proyecto está bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

WeaveTab-MCP