Google Analytics MCP Server

Google Analytics 4 (GA4) MCP サーバー 📊

Google Analytics 4 用の Model Context Protocol（MCP）サーバーです。AI エージェント向けに、リアルタイムのクエリ探索、スキーマの検出、指標の集計、オーディエンス分析を提供します。

🌐 ドキュメントとウェブポータル：https://ga4.builditwithai.xyz

---

⚡ クイックスタート

# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://ga4.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx google-analytics-mcp
uvx --from google-analytics-mcp ga4-mcp-server
python -m ga4_mcp
npx -y @surendranb/google-analytics-mcp

---

---

🤖 クライアントのセットアップ

A. Claude Code（CLI）

claude mcp add google-analytics -- uvx google-analytics-mcp

B. Cursor と Google Antigravity（mcp.json）

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"]
    }
  }
}

C. Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"],
      "env": {
        "GA4_PROPERTY_ID": "your_ga4_property_id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
      }
    }
  }
}

D. VS Code（Cline / Roo Code / Continue）

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "@surendranb/google-analytics-mcp"]
    }
  }
}

---

🛠️ ツールと機能

ツール名	パラメーター	説明	戻り値の型
get_ga4_data	dimensions（リスト）、metrics（リスト）、date_ranges（リスト）、limit（整数）	複数のディメンションを使った GA4 レポートを実行し、指標の合計を自動計算してサーバー側で集計します。	JSON / Markdown
list_accounts	(なし)	アクセス可能なすべての Google Analytics アカウントと権限レベルを一覧表示します。	JSON
list_properties	account_id（任意）	アカウントに関連付けられたすべての GA4 プロパティを一覧表示します。	JSON
get_property_metadata	property_id（任意）	ディメンションと指標の完全なスキーマ、カスタム定義、互換性ルールを取得します。	JSON
run_realtime_report	metrics（リスト）、dimensions（リスト）	過去 30 分間のリアルタイムのアクティブユーザー数とイベント数を取得します。	JSON
search_skills	query（文字列）	組み込みの GA4 分析プレイブック（eコマース、チャネルアトリビューション、ボットフィルタリング）を検索します。	Markdown
skill_read	skill_name（文字列）	手順をまとめたスキルと分析ガイドを GitHub から動的に読み込みます。	Markdown
skills_list	(なし)	利用可能なすべての GA4 分析スキルを一覧表示します。	JSON

---

🧠 動的スキルとガイド付きプレイブック

このサーバーには、GitHub から動的に読み込まれる分析レシピが組み込まれています。

• traffic-diagnosis：トラフィックが急減した原因を段階的に分析します。
• channel-acquisition：ベストプラクティスに基づくチャネルのグループ化とアトリビューションモデルを提供します。
• ecommerce-analysis：収益、商品購入率、コンバージョンファネルを分析します。
• ai-referral-analysis：ChatGPT、Claude、Perplexity、Gemini からのリファラルトラフィックを追跡し、切り分けます。

---

🔒 テレメトリとプライバシー

このパッケージは、ツールの信頼性向上のため、個人を特定できる情報を含まない匿名の診断テレメトリ（コマンドの実行、遅延、エラーコード）を収集します。クエリ、ユーザー認証情報、個人データ、ソースコード、環境変数を収集または保存することはありません。

次の環境変数のいずれかを設定すれば、いつでもオプトアウトできます。

export DO_NOT_TRACK=1
# or
export MCP_TELEMETRY_OPT_OUT=1

---

📄 ライセンス

MIT ライセンスです。詳細は LICENSE をご覧ください。