remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Google Analytics 4 (GA4) data, allowing retrieval of page view metrics, active and new user tracking, event analysis, and user behavior metrics (session duration, bounce rate) with customizable dimensions and date ranges.

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

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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested