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

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

Этот репозиторий содержит исходный код для запуска локального 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: mcp-server-google-analytics

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

✨ Посмотрите руководство по настройке 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?

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

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

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