Google Analytics MCP Server

基本能力

产品定位

Google Analytics MCP Server 是一个专门用于访问和分析 Google Analytics 4 (GA4) 数据的 MCP 服务器实现。

核心功能

• 获取可自定义维度的页面浏览量指标
• 跟踪活跃用户和新用户随时间的变化
• 分析特定事件及其指标
• 监控用户行为指标（会话时长、跳出率）
• 为所有查询提供灵活的日期范围选择

适用场景

• 网站流量分析
• 用户行为研究
• 营销活动效果评估
• 产品使用情况监控
• 数据驱动的决策支持

工具列表

1. getPageViews - 获取特定日期范围内的页面浏览量指标
2. getActiveUsers - 获取活跃用户指标
3. getEvents - 获取事件指标
4. getUserBehavior - 获取用户行为指标

常见问题解答

• 确保已正确设置环境变量
• 检查服务账户权限是否正确配置
• 确认 GA4 属性 ID 是否正确
• 定期轮换服务账户凭证
• 监控 API 使用情况并根据需要实施速率限制

使用教程

使用依赖

• Node.js 20 或更高版本
• Google Analytics 4 属性
• 启用了 Analytics Data API 的 Google Cloud 项目
• 具有适当权限的服务账户凭证

安装教程

1. 创建一个 Google Cloud 项目并启用 Analytics Data API
2. 创建一个服务账户并下载凭证 JSON 文件
3. 授予服务账户对 GA4 属性的适当访问权限
4. 设置环境变量：

export GOOGLE_CLIENT_EMAIL="[email protected]"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"

1. 安装 MCP 服务器：

pnpm install mcp-server-google-analytics

调试方式

1. 启动服务器：

pnpm start

1. 在 Claude Desktop 配置中添加以下内容：

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "[email protected]",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

1. 使用提供的函数（如 getPageViews、getActiveUsers 等）进行数据查询和分析。

许可证

该项目遵循 MIT 开源许可条款。