Google Analytics 4 MCP 服务器

一个基于 Model Context Protocol (MCP) 的实现，用于通过 TypeScript SDK 访问 Google Analytics 4 (GA4) 数据。

功能

• 获取可自定义维度的页面视图指标
• 跟踪一段时间内的活跃用户和新用户
• 分析特定事件及其指标
• 监控用户行为指标（会话时长、跳出率）
• 所有查询支持灵活的时间范围选择

先决条件

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

安装

pnpm install mcp-server-google-analytics

使用方法

启动服务器

pnpm start

在 Claude Desktop 中的配置

在你的 Claude Desktop 配置中添加以下内容：

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

可用功能

getPageViews

获取特定时间段内的页面视图指标：

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

getActiveUsers

获取活跃用户指标：

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

getEvents

获取事件指标：

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

getUserBehavior

获取用户行为指标：

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

安全注意事项

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

为项目做贡献

欢迎贡献！请阅读我们的 Contributing Guide 了解代码规范和提交Pull Request的流程。

许可证

本项目在 MIT License 下开源，具体信息请查看 LICENSE 文件。