MCP Server for Google Analytics 4

基本能力

产品定位

MCP Server for Google Analytics 4 是一个用于与Google Analytics 4（GA4）API交互的服务器，旨在帮助开发者和管理员轻松获取和分析GA4的数据。

核心功能

• 工具：
• get-page-views：获取指定日期范围内的页面浏览量指标。
• get-active-users：获取指定日期范围内的活跃用户指标。
• get-events：获取指定日期范围内的事件指标。
• get-user-behavior：获取用户行为指标，如会话时长和跳出率。
• 资源：
• ga4://property-info：GA4属性的元数据，包括可用维度、指标和比较。
• ga4://dimensions：可用的GA4维度列表。
• ga4://filters-help：关于使用GA4过滤器的帮助文档。
• ga4://metrics：可用的GA4指标列表。
• 提示：
• analyze-data：数据分析助手。
• create-report：报告生成模板。
• select-dimensions：帮助选择适合分析目标的维度。

适用场景

• 数据分析：获取和分析GA4的数据指标。
• 报告生成：自动生成数据分析报告。
• 用户行为分析：分析用户行为指标，优化用户体验。

使用教程

使用依赖

• 前置依赖：
• Google Analytics 4 属性。
• 具有访问GA4 API权限的Google Cloud服务账户。
• Node.js 20或更高版本。
• pnpm包管理器。

安装教程

# 克隆仓库
git clone https://github.com/yourusername/mcp-server-ga4.git
cd mcp-server-ga4

# 使用pnpm安装依赖
pnpm install

# 创建.env文件
cp .env.example .env

# 编辑.env文件并设置您的凭据
# GOOGLE_CLIENT_EMAIL=your-service-account-email@example.iam.gserviceaccount.com
# GOOGLE_PRIVATE_KEY=your-private-key
# GA_PROPERTY_ID=your-ga4-property-id

调试方式

# 构建服务器
pnpm run build

# 运行服务器
pnpm start

集成Claude for Desktop

在claude_desktop_config.json文件中添加以下内容：

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["/path/to/mcp-server-ga4/dist/index.js"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_CLIENT_EMAIL": "[email protected]",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

测试

使用MCP Inspector进行测试：

pnpm dlx @modelcontextprotocol/inspector node /path/to/mcp-server-ga4/dist/index.js

常见问题解答

• 认证错误：检查您的服务账户密钥和权限。
• 无数据显示：验证日期范围和属性ID是否正确。
• 连接错误：检查您的网络设置和防火墙。

许可证

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