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

$3

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

``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

$3

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.

$3


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

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