ga4-mcp-server by Shin-sibainu - MCP Server

GA4 MCP Server

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 でサービスアカウントを作成

Google Cloud Console にアクセス
プロジェクトを選択（または新規作成）
「IAM と管理」→「サービスアカウント」→「サービスアカウントを作成」
名前を入力して作成
「キー」タブ →「鍵を追加」→「新しい鍵を作成」→ JSON形式でダウンロード

2. API の有効化

「APIとサービス」→「ライブラリ」で以下を有効化:

Google Analytics Data API
Google Analytics Admin API

3. GA4 プロパティへのアクセス権付与

Google Analytics にアクセス
「管理」→「プロパティのアクセス管理」
サービスアカウントのメールアドレス（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"
      }
    }
  }
}

設定ファイルの場所

アプリ	設定ファイル
Claude Desktop (Mac)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Cursor	`.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

比較・分析系

「先週と今週を比較して」
→ 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

注意事項

レート制限: GA4 Data API には 1 プロジェクトあたり 1 日 50,000 リクエストの制限があります
データの遅延: GA4のデータは通常24-48時間の遅延があります（リアルタイムレポートを除く）
ファネル分析の制限: GA4 Data APIでは真のファネル分析に制限があります。より正確な分析にはBigQuery Exportが必要です

ライセンス

MIT

Shin-sibainu/ga4-mcp-server