适合谁
- 已使用 Gemini CLI、Gemini Code Assist 或 Claude Code 并希望用自然语言查询 Google Analytics 数据的用户
- 拥有 Google Cloud 项目与 Google Analytics 访问权限、能配置 ADC 凭据的分析人员
- 需要本地运行、自行管理凭据的团队
G
62FMRS · C
这是 Google Analytics 官方仓库提供的实验性本地 MCP 服务器，把 Admin API 与 Data API 的报告能力封装为若干 MCP 工具，让 Gemini CLI、Gemini Code Assist 和 Claude Code 等客户端可以用自然语言查询账号、媒体资源、核心报告、漏斗报告与实时报告。它适合已有 Google Cloud 项目且能配置只读 ADC 凭据的分析人员；不适合无法配置凭据或需要写入操作的用户。主要风险在于实验性状态以及本地凭据文件的保管。
这是 Google Analytics 官方仓库提供的本地 MCP 服务器源码，通过 Google Analytics Admin API 与 Data API 向 LLM 暴露账号、媒体资源信息以及核心、漏斗和实时报告能力。服务器以本地方式运行，需要配置 Python（pipx）、Google Analytics 凭据（Application Default Credentials，只读范围）以及在客户端（如 Gemini CLI、Gemini Code Assist、Claude Code）中注册。该仓库标注为实验性（Experimental）。
工具能力
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 实时报告。
安装接入
- 安装 pipx（用于运行 Python 工具）。
- 在 Google Cloud 项目中启用 Google Analytics Admin API 和 Google Analytics Data API。
- 配置 Application Default Credentials（ADC），凭据需属于有权访问相应 Google Analytics 账号或媒体资源的用户，并包含只读范围 https://www.googleapis.com/auth/analytics.readonly。可用 gcloud auth application-default login（配合 --scopes 与 --client-id-file，或使用 --impersonate-service-account）完成，命令结束后会输出凭据 JSON 路径。
- 安装 Gemini CLI 或 Gemini Code Assist，并编辑 ~/.gemini/settings.json，在 mcpServers 中加入 analytics-mcp 条目，将 GOOGLE_APPLICATION_CREDENTIALS 指向凭据 JSON 路径，并建议设置 GOOGLE_PROJECT_ID 为你的 Google Cloud 项目 ID。
- 或在 Claude Code 中执行 claude mcp add analytics-mcp --scope user -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" -e "GOOGLE_PROJECT_ID=YOUR_PROJECT_ID" -- pipx run analytics-mcp。
- 启动客户端并输入 /mcp，确认列表中显示 analytics-mcp。
claude_desktop_config.json
{
"mcpServers": {
"analytics-mcp": {
"command": "pipx",
"args": ["run", "analytics-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
"GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
}
}
}
}
选型与风险
不适合谁
- 没有 Google Analytics 访问权限或无法配置 Google Cloud 凭据的用户
- 希望完全免配置、开箱即用的用户
- 需要写入或修改 Google Analytics 配置的场景（凭据为只读范围）
- 对实验性软件稳定性有严格生产要求的场景
所需权限
- Application Default Credentials 凭据，需属于有权访问目标 Google Analytics 账号或媒体资源的用户
- Google Analytics 只读范围 https://www.googleapis.com/auth/analytics.readonly
- Google Cloud 项目中启用 Google Analytics Admin API 与 Google Analytics Data API
- 可选：用于配额与计费归属的 Google Cloud 项目 ID（GOOGLE_PROJECT_ID）
风险与副作用
- 服务器为实验性版本，行为与接口可能变化
- 凭据以 JSON 文件形式保存在本地并由环境变量指向，若文件泄露可能导致 Google Analytics 数据被读取
- 查询由 LLM 生成，可能产生不准确或非预期的报告请求
- 需要联网访问 Google Analytics API
常见排障
- 在客户端执行 /mcp，确认 analytics-mcp 已出现在服务器列表中
- 确认已在 Google Cloud 项目中启用 Admin API 与 Data API
- 确认 GOOGLE_APPLICATION_CREDENTIALS 指向正确的凭据 JSON 路径，且凭据包含 analytics.readonly 范围
- 确认凭据对应的用户有权访问目标 Google Analytics 账号或媒体资源
- 使用 pipx run analytics-mcp 检查命令是否可正常执行
- 如报告返回异常，尝试用更明确的媒体资源名称或时间范围重新提问
使用场景
询问账号下有哪些 Google Analytics 媒体资源
查询某个媒体资源的详细信息与配置
分析一段时间内最热门的事件
查看用户是否大多处于登录状态
查看媒体资源的自定义维度与自定义指标
查看关联的 Google Ads 账号链接
运行实时报告与漏斗报告
支持客户端
Gemini CLI完整支持
Gemini Code Assist完整支持
Claude Code完整支持