Googleanalytics MCP Server

一個基於MCP協議的Google Analytics數據API服務，提供報表查詢、受眾管理、元數據訪問等功能。

營銷研究與數據 #數據分析 #受眾管理 #API服務 .JavaScript

評分 : 2分

下載量 : 7.8K

更新時間 : 2025-04-29

打開站點

什麼是Google Analytics Data API MCP Server？

Google Analytics Data API MCP Server是一款用於與Google Analytics Data API交互的工具。它允許您運行標準和透視報告、批量處理數據、創建和管理受眾群體，並獲取關於維度和指標的元數據。

如何使用Google Analytics Data API MCP Server？

要開始使用，請按照以下步驟操作：安裝依賴項、配置環境變量、啟動服務器並測試連接。

適用場景

適用於需要即時分析網站流量、優化用戶體驗以及深入瞭解用戶行為的企業和個人。

主要功能

運行標準報告

根據指定的時間範圍、維度和指標生成標準報告。

批量運行報告

同時運行多個報告以節省時間。

受眾群體管理

創建、更新、刪除和列出受眾群體。

檢查維度與指標兼容性

確保所選維度和指標可以一起使用。

優勢

強大的數據分析能力

支持多種查詢方式（標準、透視、批量）

易於集成到現有系統中

侷限性

需要具備一定的技術背景才能完全利用其潛力

對Google Cloud賬戶有特定權限要求

如何使用

安裝依賴項

運行npm install以安裝所需依賴。

配置環境變量

創建.env文件並填寫必要的Google Analytics憑據。

啟動服務器

運行npm start以啟動MCP服務器。

測試連接

使用npm run inspect進行連接測試。

使用案例

運行基本報告

生成一個包含國家和地區設備類別的活躍用戶和會話數的報告。

創建受眾群體

定義一個名為“高價值用戶”的受眾群體，篩選出完成購買的用戶。

常見問題

我需要哪些前置條件來使用該服務器？

如何檢查維度和指標的兼容性？

如果我遇到錯誤怎麼辦？

🚀 Google Analytics 數據 API MCP 服務器

這是一個用於與 Google Analytics 數據 API v1 進行交互的模型上下文協議（MCP）服務器。該服務器提供了豐富的工具和資源，可用於查詢 Google Analytics 數據、管理受眾以及訪問元數據，為用戶提供了便捷的數據處理和分析途徑。

✨ 主要特性

運行標準報告和透視表報告，滿足多樣化的數據展示需求。
具備批量處理報告功能，提高數據處理效率。
可訪問維度和指標的元數據，深入瞭解數據結構。
支持創建、列出、更新和刪除受眾，方便進行受眾管理。
能夠檢查維度和指標之間的兼容性，確保數據查詢的準確性。
提供全面的資源端點以探索 GA 數據，便於用戶挖掘數據價值。

📦 安裝指南

先決條件

Node.js 14 或更高版本
Google Analytics 4 賬號屬性
具備適當權限的 Google Cloud 服務賬戶

安裝步驟

克隆此倉庫。
安裝依賴項：
```
npm install
```

根據 .env.example 創建一個 .env 文件，並填寫您的 Google Analytics 憑證：

GOOGLE_CLIENT_EMAIL=your-service-account-email@project-id.iam.gserviceaccount.com
GOOGLE_PRIVATE_KEY=your-private-key
DEFAULT_PROPERTY_ID=properties/123456789

💻 使用示例

運行服務器

npm start

使用 MCP 檢查工具進行測試

npm run inspect

基礎用法

// 運行基本報告
{
  "propertyId": "properties/123456789",
  "dateRanges": [
    {
      "startDate": "7daysAgo",
      "endDate": "yesterday"
    }
  ],
  "dimensions": [
    {
      "name": "country"
    },
    {
      "name": "deviceCategory"
    }
  ],
  "metrics": [
    {
      "name": "activeUsers"
    },
    {
      "name": "sessions"
    }
  ]
}

高級用法

// 創建受眾群體
{
  "propertyId": "properties/123456789",
  "displayName": "High Value Users",
  "description": "Users who have completed a purchase",
  "membershipDurationDays": 30,
  "filterClauses": [
    {
      "filterExpression": {
        "andGroup": {
          "expressions": [
            {
              "filter": {
                "fieldName": "eventName",
                "stringFilter": {
                  "value": "purchase",
                  "matchType": "EXACT"
                }
              }
            }
          ]
        }
      }
    }
  ]
}

📚 詳細文檔

可用工具

runReport：運行 Google Analytics 數據的標準報告。
batchRunReports：批量運行多個報告。
runPivotReport：運行帶有透視表的報告。
batchRunPivotReports：批量運行帶有透視表的報告。
getMetadata：獲取維度和指標的元數據。
checkCompatibility：檢查維度和指標之間的兼容性。
createAudience：創建新的受眾群體。
listAudiences：列出某個屬性下的所有受眾群體。
getAudience：獲取特定受眾群體的詳細信息。
deleteAudience：刪除某個受眾群體。
updateAudience：更新現有的受眾群體。

可用資源

ga://property/{propertyId}：獲取屬性信息。
ga://report/{propertyId}/{reportType}/{dimensions}/{metrics}/{startDate}/{endDate}：生成報告。
ga://metadata：獲取 API 元數據。
ga://dimensions：按類別瀏覽維度。
ga://dimensions/{category}：獲取特定類別的所有維度。
ga://metrics：按類別瀏覽指標。
ga://metrics/{category}：獲取特定類別的所有指標。
ga://audiences/{propertyId}：列出某個屬性下的所有受眾群體。
ga://audiences/{propertyId}/{audienceId}：獲取特定受眾群體的詳細信息。