MCP-сервер Google Analytics (экспериментальный)

Этот репозиторий содержит исходный код для запуска локального MCP-сервера, который взаимодействует с API Google Analytics.

Присоединяйтесь к обсуждению и задавайте вопросы в канале 🤖-analytics-mcp в Discord.

Инструменты 🛠️

Сервер использует Google Analytics Admin API и Google Analytics Data API для предоставления ряда инструментов для использования с LLM.

Получение информации об аккаунте и ресурсе 🟠

• get_account_summaries: Получает информацию об аккаунтах и ресурсах Google Analytics пользователя.

• get_property_details: Возвращает подробную информацию о ресурсе.

• list_google_ads_links: Возвращает список ссылок на аккаунты Google Ads для ресурса.

Запуск основных отчетов 📙

• run_report: Запускает отчет Google Analytics с использованием Data API.

• run_funnel_report: Запускает отчет по воронке Google Analytics с использованием Data API.

• get_custom_dimensions_and_metrics: Получает специальные параметры и показатели для конкретного ресурса.

Запуск отчетов в реальном времени ⏳

• run_realtime_report: Запускает отчет Google Analytics в реальном времени с использованием Data API.

Related MCP server: Google Analytics MCP Server

Инструкции по настройке 🔧

✨ Посмотрите руководство по настройке MCP для Google Analytics на YouTube, чтобы пройти пошаговое обучение.

Настройка включает следующие шаги:

1. Настройка Python.

2. Настройка учетных данных для Google Analytics.

3. Настройка Gemini.

Настройка Python 🐍

Установите pipx.

Включение API в вашем проекте ✅

Следуйте инструкциям, чтобы включить следующие API в вашем проекте Google Cloud:

• Google Analytics Admin API

• Google Analytics Data API

Настройка учетных данных 🔑

Настройте свои учетные данные по умолчанию для приложений (ADC). Убедитесь, что учетные данные принадлежат пользователю с доступом к вашим аккаунтам или ресурсам Google Analytics.

Учетные данные должны включать область доступа Google Analytics только для чтения:

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

Ознакомьтесь с разделом Управление клиентами OAuth, чтобы узнать, как создать клиент OAuth.

Вот несколько примеров команд gcloud, которые могут быть полезны:

• Настройка ADC с использованием учетных данных пользователя и настольного или веб-клиента OAuth после загрузки JSON-файла клиента в 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

• Настройка ADC с использованием олицетворения сервисного аккаунта.

  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

Когда команда gcloud auth application-default завершится, скопируйте путь к файлу PATH_TO_CREDENTIALS_JSON, выведенный в консоли, в следующем сообщении. Он понадобится вам для следующего шага!

Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]

Настройка Gemini

1. Установите Gemini CLI или Gemini Code Assist.

2. Создайте или отредактируйте файл ~/.gemini/settings.json, добавив свой сервер в список mcpServers.

   Замените PATH_TO_CREDENTIALS_JSON на путь, который вы скопировали на предыдущем шаге.

   Мы также рекомендуем добавить атрибут GOOGLE_CLOUD_PROJECT в объект env. Замените YOUR_PROJECT_ID в следующем примере на идентификатор проекта вашего проекта 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"
         }
       }
     }
   }

Попробуйте сами 🥼

Запустите Gemini Code Assist или Gemini CLI и введите /mcp. Вы должны увидеть analytics-mcp в результатах.

Вот несколько примеров запросов для начала работы:

• Спросите, что может делать сервер:

  what can the analytics-mcp server do?

• Спросите о ресурсе Google Analytics:

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

• Запросите анализ:

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

• Спросите о вошедших в систему пользователях:

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

• Спросите о конфигурации ресурса:

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

Участие в разработке ✨

Мы приветствуем ваш вклад! См. Руководство по участию.