MCP-Google Analytics 4数据服务器

@ruchernchong/mcp-server-google-analytics

0 Stars 57 次浏览 ruchernchong 更新于 2026-08-23

一个用于访问Google Analytics 4（GA4）数据的MCP服务器实现，使用Model Context Protocol TypeScript SDK构建。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：GA_PROPERTY_ID、GOOGLE_CLIENT_EMAIL、GOOGLE_PRIVATE_KEY

服务介绍

Google Analytics MCP 服务器

这是一个使用 Model Context Protocol TypeScript SDK 构建的用于访问 Google Analytics 4 (GA4) 数据的 MCP 服务器实现。

特性

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

前提条件

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

设置

创建一个 Google Cloud 项目并启用 Analytics Data API
创建服务账户并下载凭据 JSON 文件
授予服务账户对您的 GA4 属性的适当访问权限
设置环境变量：

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Google Analytics 服务器：

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

手动安装

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"] // Optional
}

getActiveUsers

获取活跃用户指标：

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

getEvents

获取事件指标：

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

getUserBehavior

获取用户行为指标：

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

安全注意事项

总是使用环境变量来存储敏感凭据
实施适当的 CORS 设置
在设置服务账户权限时遵循最小权限原则
定期轮换服务账户凭据
监控 API 使用情况并在必要时实施速率限制

贡献

欢迎贡献！请阅读我们的贡献指南，了解我们的行为准则以及提交拉取请求的过程详情。

许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

查看源码项目主页