Google Analytics MCP 服务器（实验性）

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

本仓库包含用于运行本地 MCP 服务器的源代码，该服务器可与 Google Analytics 的 API 进行交互。

欢迎加入 Discord 上的 🤖-analytics-mcp 频道参与讨论并提问。

工具 🛠️

该服务器使用 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：使用 Data API 运行 Google Analytics 报告。

• run_funnel_report：使用 Data API 运行 Google Analytics 漏斗报告。

• get_custom_dimensions_and_metrics：获取特定媒体资源的自定义维度和指标。

运行实时报告 ⏳

• run_realtime_report：使用 Data API 运行 Google Analytics 实时报告。

Related MCP server: mcp-server-google-analytics

设置说明 🔧

✨ 在 YouTube 上观看 Google Analytics MCP 设置教程，获取这些说明的分步演练。

👁 Watch the video

设置包括以下步骤：

1. 配置 Python。

2. 配置 Google Analytics 凭据。

3. 配置 Gemini。

配置 Python 🐍

安装 pipx。

在项目中启用 API ✅

按照说明在您的 Google Cloud 项目中启用以下 API：

• Google Analytics Admin API

• Google Analytics Data API

配置凭据 🔑

配置您的 应用默认凭据 (ADC)。请确保凭据属于有权访问您的 Google Analytics 账户或媒体资源的用户。

凭据必须包含 Google Analytics 只读范围：

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

查看 管理 OAuth 客户端 以了解如何创建 OAuth 客户端。

以下是一些您可能会觉得有用的 gcloud 命令：

• 在将客户端 JSON 下载到 YOUR_CLIENT_JSON_FILE 后，使用用户凭据和 OAuth 桌面或 Web 客户端设置 ADC。

  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 替换为您在上一步中复制的路径。

   我们还建议您在 env 对象中添加 GOOGLE_CLOUD_PROJECT 属性。将以下示例中的 YOUR_PROJECT_ID 替换为您 Google Cloud 项目的 项目 ID。

   {
    "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