Google Analytics MCP Server

Google Analytics MCP Server

为谷歌分析提供模型上下文协议服务器，使LLM能够获取和分析网站分析数据。

GitHub
Created Byruchernchongruchernchong

smithery 徽章

此 MCP 服务器允许大语言模型访问和分析 Google Analytics 4 (GA4) 数据。

功能概览

  • 页面浏览量分析（可自定义维度）
  • 活跃用户和新用户趋势追踪
  • 事件分析
  • 用户行为指标监控（会话时长、跳出率）
  • 灵活的日期范围选择

快速设置

前提条件

  • Node.js 20+
  • GA4 属性
  • 启用了 Analytics Data API 的 Google Cloud 项目
  • 服务账户凭据

安装方式

通过 Smithery（推荐）:

npx -y @smithery/cli install mcp-server-google-analytics --client claude

手动安装:

pnpm install mcp-server-google-analytics

环境配置

设置必要环境变量:

GOOGLE_CLIENT_EMAIL="your-service-account@project-id.iam.gserviceaccount.com"
GOOGLE_PRIVATE_KEY="your-private-key"
GA_PROPERTY_ID="your-ga4-property-id"

Claude Desktop 配置

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project-id.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

主要功能使用

获取页面浏览量

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"]
}

获取活跃用户

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

获取事件数据

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase"
}

获取用户行为指标

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

安全建议

  • 使用环境变量存储凭据
  • 实施适当的 CORS 设置
  • 遵循最小权限原则
  • 定期轮换服务账户凭据

更多资源