google-analytics-mcp

google-analytics-mcp

surendranbApache-2.0
212 звёзд45 форков
MCP-сервер, который подключает Google Analytics 4 к AI-агентам. Разработчики и аналитики получают прямой доступ к данным веб-аналитики прямо из диалога с ассистентом. Вам больше не нужно вручную экспортировать CSV или писать сложные запросы к API — AI сам запрашивает данные, сервер подготавливает их к анализу. Сервер работает на своей стороне: агрегирует метрики, подбирает безопасные лимиты и предупреждает, если запрос слишком тяжёлый для контекста. Ассистент получает чистые данные и отвечает быстрее. Сервер подходит для Claude Desktop, ChatGPT, Cursor, Windsurf и любых других MCP-клиентов.
Открыть на GitHub

Установка

uvx google-analytics-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикsurendranb
  • ЛицензияApache-2.0

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Запрашивать отчёты по трафику, конверсиям и поведению пользователей прямо из диалога с AI-ассистентом
  • Автоматически загружать схему данных выбранного GA4-свойства — список всех доступных измерений и метрик
  • Исследовать метрики и измерения по категориям для точной настройки отчётов
  • Выполнять кастомные запросы с серверной агрегацией — AI получает только нужное без лишних строк
  • Оценивать объём данных до выполнения сложного запроса — защита от перегрузки контекста и превышения лимитов
  • Работать с сервером из любого MCP-совместимого приложения: десктопные чаты, IDE-копилоты, скрипты и автоматизация

Как подключить

1. Установите сервер

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

uvx google-analytics-mcp

2. Настройте доступ к Google Analytics

Создайте сервисный аккаунт в Google Cloud Console и включите Google Analytics Data API. Добавьте этот аккаунт в ваше GA4-свойство на уровне просмотра. Скачайте JSON-ключ сервисного аккаунта.

3. Добавьте конфигурацию в клиент

Пропишите сервер в настройках MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "google-analytics": { "command": "uvx", "args": ["google-analytics-mcp"], "env": { "GA4_PROPERTY_ID": "123456789", "GOOGLE_APPLICATION_CREDENTIALS": "/home/user/service-account.json" } } } }

4. Перезапустите клиент

После перезапуска AI-агент увидит инструменты Google Analytics и сможет выполнять запросы к вашим данным.

Примеры запросов

  • «Покажи топ-10 страниц по просмотрам за последние 7 дней»
  • «Найди, какой канал привлёк больше всего пользователей за последний месяц, и сравни с прошлым периодом»
  • «Сравни конверсию в покупку между мобильными и десктопными пользователями за квартал»
  • «Дай отчёт по новым пользователям в разрезе географии за вчерашний день»

Технические детали

  • Язык и среда выполнения: Python (3.10+)
  • Транспортный протокол: stdio
  • Лицензия: Apache 2.0
  • Разработчик: surendranb
  • Звёзд на GitHub: 212
  • Совместимые клиенты: Claude Desktop, ChatGPT, Cursor, Windsurf, любые MCP-хосты, поддерживающие Python и stdio

Поделиться