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

Related MCP server: MCP Search Analytics Server

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

1. Cree un proyecto de Google Cloud y habilite la API de datos de Analytics

2. Cree una cuenta de servicio y descargue el archivo JSON de credenciales

3. Otorgue a la cuenta de servicio el acceso adecuado a su propiedad GA4

4. 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

Instalación mediante herrería

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

pnpm start

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.