GA4 - Google Analytics MCP Server

GA4 - Google Analytics MCP Server

GA4 - Google Analytics MCP Server是一個開源伺服器實作，旨在提供安全且靈活的訪問Google Analytics 4 (GA4)數據，使用模型上下文協議(MCP)。這個伺服器允許AI應用程式和語言模型查詢並分析GA4的即時分析數據，可以直接整合到工作流程、儀表板或代理系統中。

Author: ruchernchong


查看協議

GA4 - Google Analytics MCP Server是什麼？

GA4 - Google Analytics MCP Server是一個獨立的伺服器，透過標準化的模型上下文協議，顯示Google Analytics 4的報告功能。它充當你的GA4資源與任何兼容MCP的AI工具之間的安全橋樑，使分析查詢、報告和集成AI工作流程變得快速。

如何配置

  1. Google設置

    • 在你的Google Cloud專案中啟用Google Analytics Data API。
    • 在"IAM和管理>服務帳戶"中創建服務帳戶並生成JSON憑證金鑰。
    • 許可服務帳戶對你GA4資源的"檢視人員"訪問權限。

  2. 伺服器環境

    • 配置環境變數：
      • GOOGLE_CLIENT_EMAIL：憑證JSON中的服務帳戶電子郵件
      • GOOGLE_PRIVATE_KEY：憑證JSON中的服務帳戶私鑰
      • GA_PROPERTY_ID：你的GA4資源ID

  3. 安裝

    • 全域安裝: npm install -g mcp-server-google-analytics
    • 或使用npx: npx mcp-server-google-analytics
    • 或透過Smithery安裝以進行Claude桌面集成。

  4. AI工具配置（例如：Claude桌面）

    • 在MCP伺服器下，將適當的命令和環境變數添加到你的工具配置中。

如何使用

  1. 啟動伺服器

    • 運行 pnpm start、npx mcp-server-google-analytics 或從工具集成啟動。

  2. 呼叫函數/工具

    • AI工具或LLM代理可以通過MCP接口調用例如runReport、getPageViews、getActiveUsers、getEvents或getUserBehavior等函數。
    • 將所需的字段（如日期範圍、維度、指標）作為函數參數傳遞。

  3. 範例：查詢頁面瀏覽量

    • 使用getPageViews工具，提供日期範圍和可選維度以獲取頁面瀏覽量指標。

  4. 集成

    • 將伺服器與支持MCP的任何AI客戶端或自動化系統整合，以進行動態分析訪問。

主要特點

  • 通過標準MCP函數調用訪問即時GA4分析數據。
  • 可自定義報告：選擇特定指標、維度、過濾器和期間。
  • 多個預定義工具：頁面瀏覽量、用戶指標、事件指標和行為分析。
  • 安全的服務帳戶身份驗證，所需權限最小化。
  • 獨立使用和集成使用（如Claude桌面）的安裝和配置簡單。
  • 設計為可擴展以滿足未來分析需求。

使用案例

  • 將GA4指標直接集成到AI驅動的儀表板、報告工具或助手工作流中。
  • 使聊天機器人或AI代理能夠回答有關網站/應用程序使用情況、流量趨勢或用戶參與的問題。
  • 自動生成分析摘要、群體分析或基於事件的報告。
  • 實時監控活動表現和用戶行為，來自AI啟用的產品。

常見問題

Q1: 服務帳戶需要哪些GA4權限？
A: 服務帳戶只需要對目標GA4資源的"檢視人員"訪問權限，這樣可以讀取分析數據。

Q2: 在運行過程中我的私鑰安全嗎？
A: 是的，你的私鑰和憑證只保存在伺服器端環境變數中；絕不要將金鑰暴露給客戶端或公共儲存庫。

Q3: 我可以與任何AI工具或工作流一起使用嗎？
A: 是的，只要該工具支持MCP集成，你就可以連接伺服器並訪問分析功能。

Q4: 如果我的憑證無效或未正確設置會怎麼樣？
A: 伺服器將無法與Google Analytics進行身份驗證，功能調用將返回顯示憑證問題的錯誤；請確保仔細按照設置說明操作。

Q5: 可以擴展或自定義可用工具嗎？
A: 是的，該項目是開源的，你可以貢獻或調整伺服器來支持額外的GA4查詢或自定義報告邏輯。