AI导哈

GA4数据分析服务器

一个用于从Google Analytics 4 (GA4)获取和分析数据的MCP服务器，支持多种分析工具和LLM集成。

  • by Shin-sibainu
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Shin-sibainu/ga4-mcp-server

使用说明

GA4 MCP服务器

Google Analytics 4 (GA4) 数据Claude 等LLM 可以取得、分析MCP (Model Context Protocol) 服务器。

特徴

  • 20种分析工具：不仅仅是单纯的数据取得，还搭载了很多实用的分析工具
  • 日本语对应：输出结果用日语格式化（例如：“2分34秒”，“45.2%”）
  • 灵活的期间指定: 相対日付（7daysAgo, yesterday）和绝对日期
  • 立即插入: LLM以便于直接解释的形式返还数据

必要要件

  • Node.js 18以上
  • GA4 拥有对属性的访问权限Google 账户

安装

cd ga4-mcp-server
npm install
npm run build

认证设定

方法1：gcloud CLI 使用（推荐・简单）

不需要服务帐户，自己的Google 可以通过帐户进行身份验证。

1. gcloud CLI 安装

# Windows (winget)
winget install Google.CloudSDK

# または https://cloud.google.com/sdk/docs/install からダウンロード

2.执行认证

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/analytics.readonly"

浏览器打开GA4 访问权限Google 只是用帐号登录！

就这样完成了。GOOGLE_APPLICATION_CREDENTIALS 的规格化距离的幂函数。

方法2:使用服务帐户（面向生产环境）

在团队共享和生产环境中使用服务帐户。

1. Google Cloud Console 创建服务帐户

  1. 谷歌云控制台 访问
  2. 选择项目（或新建）
  3. 「IAM 和管理-服务帐户-创建服务帐户
  4. 通过输入名称创建
  5. “密钥”选项卡→“添加密钥”→“创建新密钥”→JSON格式下载

2. API 启用

「API和服务-在库中启用：

  • 谷歌分析数据API
  • Google Analytics管理员API

3. GA4 授予对属性的访问权限

  1. 谷歌分析 访问
  2. 管理-属性访问管理
  3. 服务帐户电子邮件地址（xxx@xxx.iam.gserviceaccount.com）作为“阅览者”追加

MCP 设定

gcloud CLI 使用认证时（推荐）

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["/path/to/ga4-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789"
      }
    }
  }
}

使用服务帐户时

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["/path/to/ga4-mcp-server/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "GA4_PROPERTY_ID": "123456789"
      }
    }
  }
}

配置文件位置

应用程序设置文件 |--------|-------------| |克劳德台式机（Mac）| ~/Library/Application Support/Claude/claude_desktop_config.json | |克劳德桌面（Windows）| %APPDATA%\Claude\claude_desktop_config.json | |光标| .cursor/mcp.json（项目根目录）｜

环境变数

变数名 必须 说明
GOOGLE_APPLICATION_CREDENTIALS ｜×｜服务帐户JSON密钥路径（使用gcloud CLI时不需要）
GA4_PROPERTY_ID ｜△｜默认的GA4属性ID（工具运行时也可以指定）｜

可用工具

基本工具（5个）

工具名称｜说明｜ |----------|------| | list_accounts 获取帐户属性列表 | get_property_details ｜属性详细信息｜ | run_report ｜通用报告执行（主工具）｜ | run_realtime_report 实时报告 | get_metadata 可用的维度度量列表

分析工具（15个）

工具名称｜说明｜ |----------|------| | get_traffic_summary 业务概要（PV/UU/会话等） | get_top_pages 人气页面排行榜 | get_traffic_sources | 流入元分析 | | get_device_breakdown 按设备的访问比率 | get_geo_breakdown ｜按地区的访问分析｜ | compare_periods ｜期间比较（上周比、上月比等）｜ | get_landing_pages ｜登录页分析｜ | get_exit_pages ｜脱离页分析｜ | get_user_journey 用户日志（页面迁移） | get_conversion_funnel ｜转换法分析｜ | get_hourly_traffic ｜按时间段的访问分析｜ | get_daily_trend 每天趋势 | get_new_vs_returning 新建vs 回头客分析 | get_engagement_metrics ｜项目指标｜ | get_search_terms 网站内搜索关键词

使用例

基本问题

「今日のPV数を教えて」
→ get_traffic_summary (period: "today")

「今リアルタイムで何人見てる？」
→ run_realtime_report

排名系列

「過去7日間のアクセス数が多いページTOP10」
→ get_top_pages (period: "7days", limit: 10)

「どこからアクセスが来てる？」
→ get_traffic_sources (period: "7days", groupBy: "channel")

比较・分析系

「先週と今週を比較して」
→ compare_periods (comparisonType: "previousPeriod", period: "7days")

「モバイルとPCの比率は？」
→ get_device_breakdown (period: "7days")

深度分析

「何時頃にアクセスが多い？」
→ get_hourly_traffic (period: "7days")

「このページを見た人は次にどこに行く？」
→ get_user_journey (pagePath: "/product/123", direction: "next")

开発

# 開発モード（ファイル変更を監視してリビルド）
npm run dev

# ビルド
npm run build

# 型チェック
npm run typecheck

注意事项

  1. 汇率限制: GA4 Data API 每个项目每天有50000个请求限制
  2. 数据延迟: GA4数据通常延迟24-48小时（不包括实时报告）
  3. 法内尔分析限制: GA4 Data API对较大场景进行渲染期间已观察到该故障。更精确的分析BigQuery Export需要

许可证

麻省理工学院

相关 MCP