Servidor MCP de Google Analytics (Experimental)

👁 PyPI version
👁 Python 3.10+
👁 GitHub branch check runs
👁 PyPI - Downloads
👁 GitHub stars
👁 GitHub forks
👁 YouTube Video Views

Este repositorio contiene el código fuente para ejecutar un servidor MCP local que interactúa con las API de Google Analytics.

Únete a la conversación y haz preguntas en el canal 🤖-analytics-mcp en Discord.

Herramientas 🛠️

El servidor utiliza la API de administración de Google Analytics y la API de datos de Google Analytics para proporcionar varias Herramientas para su uso con LLM.

Recuperar información de cuentas y propiedades 🟠

• get_account_summaries: Recupera información sobre las cuentas y propiedades de Google Analytics del usuario.

• get_property_details: Devuelve detalles sobre una propiedad.

• list_google_ads_links: Devuelve una lista de enlaces a cuentas de Google Ads para una propiedad.

Ejecutar informes principales 📙

• run_report: Ejecuta un informe de Google Analytics utilizando la API de datos.

• run_funnel_report: Ejecuta un informe de embudo de Google Analytics utilizando la API de datos.

• get_custom_dimensions_and_metrics: Recupera las dimensiones y métricas personalizadas para una propiedad específica.

Ejecutar informes en tiempo real ⏳

• run_realtime_report: Ejecuta un informe en tiempo real de Google Analytics utilizando la API de datos.

Related MCP server: mcp-server-google-analytics

Instrucciones de configuración 🔧

✨ Mira el Tutorial de configuración de MCP de Google Analytics en YouTube para obtener un recorrido paso a paso de estas instrucciones.

👁 Watch the video

La configuración implica los siguientes pasos:

1. Configurar Python.

2. Configurar las credenciales para Google Analytics.

3. Configurar Gemini.

Configurar Python 🐍

Instala pipx.

Habilitar las API en tu proyecto ✅

Sigue las instrucciones para habilitar las siguientes API en tu proyecto de Google Cloud:

• API de administración de Google Analytics

• API de datos de Google Analytics

Configurar credenciales 🔑

Configura tus Credenciales predeterminadas de aplicación (ADC). Asegúrate de que las credenciales sean para un usuario con acceso a tus cuentas o propiedades de Google Analytics.

Las credenciales deben incluir el ámbito de solo lectura de Google Analytics:

https://www.googleapis.com/auth/analytics.readonly

Consulta Gestionar clientes OAuth para saber cómo crear un cliente OAuth.

Aquí tienes algunos comandos de gcloud de muestra que podrían resultarte útiles:

• Configura ADC usando credenciales de usuario y un cliente de escritorio o web de OAuth después de descargar el JSON del cliente a YOUR_CLIENT_JSON_FILE.

gcloud auth application-default login \
 --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
 --client-id-file=YOUR_CLIENT_JSON_FILE

• Configura ADC usando la suplantación de identidad de una cuenta de servicio.

gcloud auth application-default login \
 --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
 --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform

Cuando el comando gcloud auth application-default finalice, copia la ubicación del archivo PATH_TO_CREDENTIALS_JSON que aparece en la consola en el siguiente mensaje. ¡La necesitarás para el siguiente paso!

Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]

Configurar Gemini

1. Instala Gemini CLI o Gemini Code Assist.

2. Crea o edita el archivo en ~/.gemini/settings.json, añadiendo tu servidor a la lista mcpServers.

   Reemplaza PATH_TO_CREDENTIALS_JSON con la ruta que copiaste en el paso anterior.

   También recomendamos que añadas un atributo GOOGLE_CLOUD_PROJECT al objeto env. Reemplaza YOUR_PROJECT_ID en el siguiente ejemplo con el ID del proyecto de tu proyecto de Google Cloud.

   {
    "mcpServers": {
    "analytics-mcp": {
    "command": "pipx",
    "args": ["run", "analytics-mcp"],
    "env": {
    "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
    "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
    }
    }
    }
   }

Pruébalo 🥼

Inicia Gemini Code Assist o Gemini CLI y escribe /mcp. Deberías ver analytics-mcp en los resultados.

Aquí tienes algunos ejemplos de prompts para empezar:

• Pregunta qué puede hacer el servidor:

what can the analytics-mcp server do?

• Pregunta sobre una propiedad de Google Analytics

Give me details about my Google Analytics property with 'xyz' in the name

• Solicita un análisis:

what are the most popular events in my Google Analytics property in the last 180 days?

• Pregunta sobre los usuarios que han iniciado sesión:

were most of my users in the last 6 months logged in?

• Pregunta sobre la configuración de la propiedad:

what are the custom dimensions and custom metrics in my property?

Contribución ✨

¡Las contribuciones son bienvenidas! Consulta la Guía de contribución.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• get_account_summariesB
• get_custom_dimensions_and_metricsA
• get_property_detailsB
• list_google_ads_linksA
• list_property_annotationsA
• run_conversions_reportA
• run_funnel_reportA
• run_realtime_reportA