Google Analytics MCP Server

Google Analytics 4 (GA4) MCP 服务 📊

Google Analytics 4 的 Model Context Protocol (MCP) 服务：为 AI Agent 提供实时查询探索、架构发现、指标汇总和受众洞察。

🌐 在线文档与 Web 门户：https://ga4.builditwithai.xyz

---

⚡ 快速开始

# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://ga4.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx google-analytics-mcp
uvx --from google-analytics-mcp ga4-mcp-server
python -m ga4_mcp
npx -y @surendranb/google-analytics-mcp

---

---

🤖 客户端配置

A. Claude Code（CLI）

claude mcp add google-analytics -- uvx google-analytics-mcp

B. Cursor 与 Google Antigravity（mcp.json）

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"]
    }
  }
}

C. Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"],
      "env": {
        "GA4_PROPERTY_ID": "your_ga4_property_id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
      }
    }
  }
}

D. VS Code（Cline / Roo Code / Continue）

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "@surendranb/google-analytics-mcp"]
    }
  }
}

---

🛠️ 工具与功能

工具名称	参数	描述	返回类型
get_ga4_data	dimensions（列表）、metrics（列表）、date_ranges（列表）、limit（整数）	运行多维 GA4 报告，并自动计算指标总计和进行服务端汇总。	JSON / Markdown
list_accounts	（无）	列出所有可访问的 Google Analytics 账号及权限级别。	JSON
list_properties	account_id（可选）	列出与账号关联的所有 GA4 属性。	JSON
get_property_metadata	property_id（可选）	获取完整的维度和指标架构、自定义定义及兼容性规则。	JSON
run_realtime_report	metrics（列表）、dimensions（列表）	查询过去 30 分钟内的实时活跃用户和事件数。	JSON
search_skills	query（字符串）	搜索内置的 GA4 分析指南（电商、渠道归因、机器人过滤）。	Markdown
skill_read	skill_name（字符串）	从 GitHub 动态加载操作技能和分析指南。	Markdown
skills_list	（无）	列出所有可用的实时 GA4 分析技能。	JSON

---

🧠 动态技能与引导式指南

此服务内置了可从 GitHub 动态加载的分析方案：

• traffic-diagnosis：针对流量骤降的逐步根因分析。
• channel-acquisition：最佳实践渠道分组与归因建模。
• ecommerce-analysis：收入、商品购买率和转化漏斗分析。
• ai-referral-analysis：跟踪并单独分析来自 ChatGPT、Claude、Perplexity 和 Gemini 的引荐流量。

---

🔒 遥测与隐私

此软件包会收集匿名、非个人身份信息（PII）的诊断遥测数据（命令执行、延迟、错误代码），以提高工具可靠性。绝不会收集或存储查询、用户凭据、个人数据、源代码或环境变量。

你可以随时通过设置以下任一环境变量选择退出：

export DO_NOT_TRACK=1
# or
export MCP_TELEMETRY_OPT_OUT=1

---

📄 许可证

MIT 许可证。详情请参阅 LICENSE。