Ganalytics MCP Server

🚀 谷歌分析 MCP 服務器

谷歌分析 MCP 服務器是一個藉助工具和服務，為用戶提供谷歌分析數據訪問能力的模型上下文協議（MCP）服務器。

測試結果（2024-03-26）

• 總活躍用戶數：102,883
• 白俄羅斯活躍用戶數：64,837（63%）
• 總頁面瀏覽量：2,422,925
• 白俄羅斯頁面瀏覽量：1,950,160（80%）

✨ 主要特性

• 支持通過 MCP 資源訪問谷歌分析的指標和維度。
• 可利用靈活的過濾選項獲取分析數據。
• 能夠獲取格式化數據，並附帶見解和建議。
• 基於 TypeScript 實現，具備強類型特性。

📦 安裝指南

1. 克隆倉庫。
2. 安裝依賴項：

   npm install
   

3. 依據 .env.example 創建一個 .env 文件，並添加您的谷歌分析憑證。
4. 構建項目：

   npm run build
   

📚 詳細文檔

設置谷歌分析憑證

1. 訪問 Google Cloud Console。
2. 創建新項目或選擇現有項目。
3. 啟用 Google Analytics Data API。
4. 創建具有適當權限的服務賬戶。
5. 下載服務賬戶密鑰（JSON 格式）。
6. 從 JSON 文件中提取客戶端電子郵件和私鑰。
7. 將這些內容添加到您的 .env 文件中：

   GA_PROPERTY_ID=your_property_id
   GA_CLIENT_EMAIL=your-service-account@your-project.iam.gserviceaccount.com
   GA_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nYourPrivateKeyHere\n-----END PRIVATE KEY-----
   

💻 使用示例

運行服務器

node build/index.js

MCP 配置

將服務器添加到您的 cline_mcp_settings.json 文件中：

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/GAnalytics-MCP-server/build/index.js"],
      "env": {
        "GA_PROPERTY_ID": "your_property_id",
        "GA_CLIENT_EMAIL": "your-service-account@your-project.iam.gserviceaccount.com",
        "GA_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\nYourPrivateKeyHere\\n-----END PRIVATE KEY-----"
      }
    }
  }
}

get_analytics_data 工具使用

基礎用法

get_analytics_data 工具可用於獲取帶有可選過濾和分析的谷歌分析數據。 參數說明：

示例代碼：

{
  "metrics": ["activeUsers", "newUsers"],
  "dimensions": ["country", "deviceCategory"],
  "startDate": "2024-03-26",
  "endDate": "2024-03-26",
  "filters": {
    "dimensionFilter": {
      "dimension": "country",
      "value": "US"
    }
  },
  "orderBy": ["activeUsers desc"],
  "limit": 10,
  "offset": 0
}

🔧 可用資源

指標

• activeUsers：活躍用戶數
• newUsers：新用戶數
• pageviews：頁面瀏覽量
• sessions：會話數
• bounceRate：跳出率

維度

• country：國家/地區
• deviceCategory：設備類別
• platform：平臺
• mobileDeviceModel：移動設備型號
• os：操作系統

🔧 技術細節

要運行測試，請執行以下命令：

npm test

📄 許可證

[此處添加許可證信息]

貢獻者

[此處列出貢獻者]