Servidor MCP de Google Analytics
Una implementación de servidor MCP para acceder a los datos de Google Analytics 4 (GA4), creada utilizando el SDK de TypeScript de Model Context Protocol.
Características
- Obtenga métricas de visitas a la página con dimensiones personalizables
- Seguimiento de usuarios activos y nuevos a lo largo del tiempo
- Analizar eventos específicos y sus métricas
- Monitorear las métricas del comportamiento del usuario (duración de la sesión, tasa de rebote)
- Selección de rango de fechas flexible para todas las consultas
Prerrequisitos
- Node.js 20 o superior
- Propiedad de Google Analytics 4
- Proyecto de Google Cloud con la API de datos de Analytics habilitada
- Credenciales de cuenta de servicio con permisos adecuados
Configuración
- Cree un proyecto de Google Cloud y habilite la API de datos de Analytics
- Cree una cuenta de servicio y descargue el archivo JSON de credenciales
- Otorgue a la cuenta de servicio el acceso adecuado a su propiedad GA4
- Configurar variables de entorno:
export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"
Instalación
Para instalar Google Analytics Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install mcp-server-google-analytics --client claude
Instalación manual
pnpm install mcp-server-google-analytics
Uso
Iniciando el servidor
Configuración en Claude Desktop
Añade esto a tu configuración de Claude Desktop:
{
"mcpServers": {
"google-analytics": {
"command": "npx",
"args": ["-y", "mcp-server-google-analytics"],
"env": {
"GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
"GOOGLE_PRIVATE_KEY": "your-private-key",
"GA_PROPERTY_ID": "your-ga4-property-id"
}
}
}
}
Funciones disponibles
obtener vistas de página
Obtener métricas de visitas a la página para un rango de fechas específico:
{
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": ["page", "country"] // Optional
}
obtener usuarios activos
Obtenga métricas de usuarios activos:
{
"startDate": "2024-01-01",
"endDate": "2024-01-31"
}
obtenerEventos
Obtener métricas de eventos:
{
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"eventName": "purchase" // Optional
}
obtenerComportamientoUsuario
Obtener métricas de comportamiento del usuario:
{
"startDate": "2024-01-01",
"endDate": "2024-01-31"
}
Consideraciones de seguridad
- Utilice siempre variables de entorno para credenciales confidenciales
- Implementar configuraciones CORS apropiadas
- Siga el principio del mínimo privilegio al configurar los permisos de la cuenta de servicio
- Rotar periódicamente las credenciales de la cuenta de servicio
- Supervisar el uso de la API e implementar una limitación de velocidad si es necesario
Contribuyendo
¡Agradecemos sus contribuciones! Lea nuestra Guía de Contribución para obtener más información sobre nuestro código de conducta y el proceso para enviar solicitudes de incorporación de cambios.
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.