Google Analytics MCP Server

概述

这是一个基于 MCP TypeScript SDK 构建的 Google Analytics 4 数据访问服务器，使 Claude 能够分析您的 GA4 数据。

前提条件

• Node.js 20+
• GA4 属性
• 已启用 Analytics Data API 的 Google Cloud 项目
• 具有适当权限的服务账户

快速设置

1. 准备 Google Cloud 凭证

# 设置环境变量
export GOOGLE_CLIENT_EMAIL="your-service-account@project-id.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"

2. 安装与启动

# 安装
pnpm install mcp-server-google-analytics

# 启动服务器
pnpm start

3. Claude Desktop 配置

将以下内容添加到您的 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

许可证

MIT 许可证