Google Analytics MCP Server 本地模型上下文协议（MCP）服务器为大型语言模型（LLMs）

Google Analytics MCP Server是一个本地模型上下文协议（MCP）服务器，通过整合Google Analytics Admin API和Data API，为大型语言模型（LLMs）特别是Gemini CLI/Code Assist，提供一套工具实现对Google Analytics数据的深度交互与智能分析。支持LLM通过自然语言查询来检索账户和属性详情、执行核心报告和实时报告，获取可用的维度与指标，简化了用户与复杂Google Analytics数据之间的交互，使数据分析更加直观和高效。

Google Analytics MCP Server服务器借助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报告。

• get_dimensions：获取特定属性的核心报告维度，包括自定义维度。

• get_metrics：获取特定属性的核心报告指标，包括自定义指标。

• get_standard_dimensions：返回标准维度列表。

• get_standard_metrics：返回标准指标列表。

• run_report_date_ranges_hints：为run_report工具的date_ranges参数提供预期值相关提示。

• run_report_metric_filter_hints：为run_report和run_realtime_report工具的metric_filter参数提供预期值相关提示。

• run_report_dimension_filter_hints：为run_report和run_realtime_report工具的dimension_filter参数提供预期值相关提示。

实时报告运行

• run_realtime_report：通过Data API运行Google Analytics实时报告。

• get_realtime_dimensions：获取实时报告维度列表。

• get_realtime_metrics：获取实时报告指标列表。

Google Analytics MCP Server搭建

配置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

配置Gemini

安装Gemini CLI或Gemini Code Assist。

创建或编辑~/.gemini/settings.json文件，在mcpServers列表中添加服务器信息：

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleanalytics/google-analytics-mcp.git",
        "google-analytics-mcp"
      ]
    }
  }
}

可选操作：在Gemini设置中配置GOOGLE_APPLICATION_CREDENTIALS环境变量。如果希望无论当前环境中选择了哪些应用默认凭据，都始终使用特定凭据集，就可以进行此操作。

在~/.gemini/settings.json中，向env对象添加GOOGLE_APPLICATION_CREDENTIALS属性。将以下示例中的PATH_TO_ADC_JSON替换为你希望用于MCP服务器的ADC JSON文件的完整路径：

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleanalytics/google-analytics-mcp.git",
        "google-analytics-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_ADC_JSON"
      }
    }
  }
}

Google Analytics MCP Server使用

启动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?