Sobre el proyecto

GA4 Dashboard & MCP es un tablero autogestionado en tiempo real de Google Analytics 4 y un servidor opcional Model Context Protocol (MCP) para asistentes de IA. ## Características del tablero - **Análisis en tiempo real**: Monitoreo de usuarios activos, comparación de propiedades, recetas de tráfico y seguimiento de cuota de API. - **Globo interactivo 3D**: Visualiza actividad web en vivo por países usando Three.js, accesible en `/globe`. - **Detección de picos de tráfico**: Detecta automáticamente aumentos repentinos y clasifica fuentes como referencia, directa o campaña. - **Información de visitantes**: Tarjetas de perfil para nuevos vs. visitantes recurrentes, desglose por dispositivo y geografía principal. - **Escudo de privacidad**: Oculta parámetros completos de URL y cadenas de consulta para evitar fugas de datos. - **Caché inteligente**: Capas de caché en disco y memoria con actualizaciones automáticas en segundo plano para preservar la cuota de API GA4. - **Página de configuración inicial**: Si no se encuentran credenciales, los usuarios son redirigidos a un flujo de configuración en el navegador. ## Servidor MCP Un paquete independiente `mcp-server/` expone herramientas de GA4 Admin y Data API a clientes compatibles con MCP como Claude Desktop, Antigravity y Cursor. Opera independientemente del tablero y tiene sus propias dependencias y credenciales. ## Requisitos previos - Node.js v18.0.0+ - Administrador de paquetes pnpm - Cuenta de Google Cloud Platform con una cuenta de servicio autorizada para Google Analytics Data API y Admin API ## Resumen de configuración 1. Clone el repositorio y ejecute `pnpm install`. 2. Cree una cuenta de servicio de Google Cloud, habilite las APIs requeridas y genere un archivo clave JSON. 3. Otorgue acceso de Visor a la propiedad GA4 y coloque la clave JSON en la raíz del proyecto (o establezca `GA4_CREDENTIALS_PATH` en `.env`). 4. Inicie la aplicación con `pnpm dev` (desarrollo) o `pnpm start` (producción). 5. Opcional: configure el servidor MCP copiando `.env.example`, apuntando `GOOGLE_APPLICATION_CREDENTIALS` a un archivo clave y agregando el servidor a la configuración de su cliente MCP. ## URLs - Tablero principal: `http://localhost:3000` - Globo 3D: `http://localhost:3000/globe` - Vista de análisis: `http://localhost:3000/analytics` ## Pruebas y compilación Ejecute `pnpm test` para la suite de pruebas unitarias Mocha y `pnpm build` para verificaciones de compilación TypeScript. Licenciado bajo la Licencia MIT.