Google Analytics MCP Server

Google Analytics MCP Server

site icon
2025.01.29 17
TypeScript数据分析网站分析用户行为分析开发效率
Google Analytics MCP Server 是一个基于 Model Context Protocol TypeScript SDK 实现的 MCP 服务器,用于访问 Google Analytics 4 (GA4) 数据。它提供了丰富的功能来获取和分析网站或应用的访问数据,包括页面浏览量、用户活跃度、事件跟踪和用户行为分析等。
View on GitHub

Overview

基本能力

产品定位

Google Analytics MCP Server 是一个数据分析工具,专门用于从 Google Analytics 4 (GA4) 获取和分析网站或应用的访问数据。

核心功能

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

适用场景

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

工具列表

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

常见问题解答

  • 安全问题:建议使用环境变量存储敏感凭证,实施适当的CORS设置,遵循最小权限原则设置服务账户权限,定期轮换服务账户凭证,并根据需要监控API使用情况和实施速率限制

使用教程

使用依赖

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

安装教程

通过 Smithery 安装

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

手动安装

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"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。