MCP Server Ga4

🚀 Google Analytics 4 的 MCP 服務器

本項目是 Google Analytics 4 的 MCP 服務器，為用戶提供豐富的 MCP 功能，涵蓋數據獲取、資源管理和數據分析等方面，助力用戶高效利用 GA4 數據。

🚀 快速開始

此為一個正在進行中的項目。服務器尚未完全測試完畢，請謹慎使用。

✨ 主要特性

此服務器提供以下 MCP 功能：

工具

• 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：幫助選擇適合分析目標的維度。

📦 安裝指南

先決條件

• 一個 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

認證

如果設置了 GOOGLE_CLIENT_EMAIL 和 GOOGLE_PRIVATE_KEY，服務器將使用服務賬戶進行認證。如果沒有設置，默認使用應用默認憑證。

請確保您的項目啟用了 Google Analytics API 並且您的服務賬戶具有必要的權限。（https://www.googleapis.com/auth/analytics.readonly）

以下是設置 Google 應用默認憑證的方法：

1. 安裝 Google Cloud SDK。
2. 運行以下命令以進行身份驗證：

gcloud auth application-default login

💻 使用示例

資源路徑示例

• ga4://property-info：獲取 GA4 屬性的元數據，包括可用維度、指標和比較項。
• ga4://dimensions：列出 GA4 的所有可用維度。
• ga4://metrics：列出 GA4 的所有可用指標。

提示功能示例

• analyze-data：幫助分析數據並提供見解。
• create-report：生成自定義報告模板。
• select-dimensions：根據目標選擇最合適的維度。

🔧 技術細節

故障排除

• 認證錯誤：檢查服務賬戶密鑰和權限。
• 無數據顯示：確認日期範圍和屬性 ID 是否正確。
• 連接錯誤：檢查網絡設置和防火牆配置。

測試

使用 MCP 檢查器測試：

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

(注意：pnpm dlx 相當於 npx 用於執行包)

📄 許可證

MIT

致謝

• https://github.com/lapras-inc/lapras-mcp-server/tree/main
  • 此項目借鑑了該倉庫的類結構實現。
• https://github.com/ruchernchong/mcp-server-google-analytics
  • 基於 Google Analytics API 的基本實現。