Custom Chrome MCP Server

Tu puente inteligente entre la IA y el Navegador.

Este servidor MCP (Model Context Protocol) permite a asistentes como Claude, Roo Code o Windsurf interactuar con Google Chrome de una manera natural y potente. A diferencia de otras herramientas de automatizaci�n, esta soluci�n se conecta a tu navegador real, permiti�ndote usar tus sesiones iniciadas, cookies y extensiones sin ser detectado.

�Por qu� usar esto?

• ** Navegaci�n "Humana":** Usa tu perfil de Chrome real. Si ya est�s logueado en LinkedIn, Gmail o tu ERP corporativo, la IA tambi�n lo estar�.
• ** Indetectable:** Tecnolog�as avanzadas de anti-detecci�n y "Shadow Profile" para evitar bloqueos en sitios complejos.
• ** Herramientas Robustas:** M�s de 40 herramientas optimizadas para extracci�n de datos (scraping), automatizaci�n de formularios y an�lisis visual.
• ** R�pido y Seguro:** Ejecuta scripts y capturas de pantalla de manera segura, truncando salidas gigantes para no saturar a la IA.

Instalaci�n R�pida

Para Usuarios (VS Code / Roo Code / Claude Desktop)

Simplemente agrega esto a tu configuraci�n de mcpServers (archivo mcp.json):

{
  "mcpServers": {
    "custom-chrome-mcp": {
      "command": "npx",
      "args": ["-y", "@eddym06/custom-chrome-mcp", "--port=9223"]
    }
  }
}

�Y listo! Al reiniciar tu asistente, tendr�s acceso a herramientas como launch_chrome_with_profile, get_html, click, type, etc.

Gu�a de Uso Simplificada

1. Iniciar el Navegador

La primera vez, pide a la IA:

"Lanza Chrome con mi perfil por default"

Esto usar� la herramienta launch_chrome_with_profile para abrir una ventana de Chrome controlable sin cerrar tus otras ventanas.

2. Navegar y Analizar

Puedes pedir cosas como:

• "Ve a amazon.com y busca laptops"
• "Analiza el HTML de esta p�gina" (Usa get_html optimizado)
• "Toma una captura de pantalla"

3. Interactuar

La IA puede hacer clic, escribir y rellenar formularios por ti de manera inteligente, esperando a que los elementos carguen.

Herramientas Destacadas

| Categor�a | Herramientas Clave | Descripci�n | |-----------|-------------------|-------------| | Navegaci�n | browser_action, manage_tabs | Control total de pesta�as, recargas y movimiento. | | An�lisis | get_html, screenshot, get_page_metrics | Ve lo que ve el usuario. get_html incluye selectores inteligentes. | | Interacci�n | perform_interaction, execute_script | Clics, escritura y ejecuci�n de JS seguro. | | Red | capture_network, resend_request | (Avanzado) Analiza tr�fico y repite peticiones API. |

Preguntas Frecuentes

�Necesito cerrar mi Chrome? No. Gracias a la tecnolog�a "Shadow Profile", el servidor crea una copia segura de tu perfil temporalmente. Puedes seguir usando tu Chrome normal mientras la IA trabaja en paralelo.

�Funciona en Mac y Linux? �S�! El sistema es totalmente multiplataforma.

Me aparece "Tool disabled by user" Esto es un tema de seguridad de tu editor (VS Code). Generalmente se soluciona reiniciando la ventana (Ctrl+R) y aprobando los nuevos permisos cuando la IA intenta usar una herramienta.

Para Desarrolladores

Si quieres contribuir o correrlo localmente:

1. Clona el repositorio.
2. Instala dependencias: npm install
3. Construye: npm run build
4. Inicia: npm start

Desarrollado con por @eddym06