AI导哈

Google Analytics API服务

用于Google Analytics 4的MCP服务器，通过Admin和Data API创建属性、配置数据流、管理转化和运行报告。

  • by stucchi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 stucchi/mcp-google-analytics

使用说明

谷歌分析4 MCP服务器

用于Google Analytics 4的MCP服务器——通过管理和数据API创建属性、配置数据流、管理转换和运行报告。

设置（一次性，约3分钟）

  1. 谷歌云控制台 → IAM和管理员→ 服务账户

    • 创建服务帐户（任何名称）
    • 点击它→ Keys → 添加关键点→ JSON → 下载

  2. 启用API 在您的GCP项目中：

  3. GA4管理员 → 物业出入管理→ 将服务帐户电子邮件（来自JSON）添加为 编辑

  4. 配置凭据 （选一个）：

    • 选项A （推荐）：将JSON内容复制到 GA_CREDENTIALS MCP配置中的env-var
    • 选项B：将文件保存到 ~/.google-analytics-4-mcp/credentials.json

完成。没有浏览器流，没有同意屏幕，没有刷新令牌。

安装

克劳德代码

claude mcp add google-analytics -e GA_CREDENTIALS='{"type":"service_account",...}' -- uvx google-analytics-4-mcp

克劳德桌面版

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-4-mcp"],
      "env": {
        "GA_CREDENTIALS": "{\"type\":\"service_account\",\"project_id\":\"...\", ...}"
      }
    }
  }
}

来源

git clone https://github.com/stucchi/mcp-google-analytics.git
cd mcp-google-analytics
uv run google-analytics-4-mcp

入门指南

  1. 检查身份验证：呼叫 check_auth_status 验证服务帐户是否已配置
  2. 列出帐户：呼叫 list_accounts 查看您的GA4帐户
  3. 设置属性：使用 create_property → create_web_data_stream → get_tracking_snippet
  4. 查询数据：使用 run_report 具有维度和度量

工具（23）

认证

工具 说明
check_auth_status 验证服务帐户是否已配置且有效

管理员API

工具 说明
list_accounts 列出可访问的GA4帐户
list_properties 列出帐户的属性
create_property 创建GA4属性
get_property 获取房产详细信息
delete_property 软删除属性
list_data_streams 列出数据流
create_web_data_stream 创建网络流→ 获取测量ID
delete_data_stream 删除数据流
get_tracking_snippet 生成gtag.js HTML代码段
list_key_events 列出转换事件
create_key_event 将事件标记为转换
delete_key_event 删除转换
list_custom_dimensions 列出自定义尺寸
create_custom_dimension 创建自定义尺寸
list_custom_metrics 列出自定义指标
create_custom_metric 创建自定义指标
list_google_ads_links 列出Google广告链接
create_google_ads_link 链接Google Ads帐户
get_measurement_protocol_secret 获取/创建测量协议密钥

数据API

工具 说明
run_report 运行包含维度、指标、日期和过滤器的报告
run_realtime_report 实时活跃用户和事件
get_metadata 列出可用的维度和指标

环境变量

变量 默认值 描述
GA_CREDENTIALS -- 服务帐户JSON密钥内容（复制粘贴整个JSON）
GA_CREDENTIALS_PATH ~/.google-analytics-4-mcp/credentials.json 替代方案：JSON密钥文件的路径

GA_CREDENTIALS 优先于 GA_CREDENTIALS_PATH.

示例用法

You: "Set up Google Analytics for my website https://mcpadvisor.stucchi.consulting"

Assistant calls: list_accounts → create_property → create_web_data_stream → get_tracking_snippet

Result: Property created with Measurement ID G-XXXXXXXXXX and ready-to-paste HTML snippet.

You: "Show me the top 10 countries by sessions in the last 7 days"

Assistant calls: run_report(property_id="...", dimensions=["country"], metrics=["sessions"], start_date="7daysAgo", limit=10)

许可证

麻省理工学院

相关 MCP