Ruchernchong MCP Server Google Analytics

🚀 Google Analytics 4 MCP 服務器

本項目是基於 Model Context Protocol (MCP) 的實現，藉助 TypeScript SDK 來訪問 Google Analytics 4 (GA4) 數據，為用戶提供了便捷且強大的 GA4 數據訪問能力。

🚀 快速開始

本服務器基於 Model Context Protocol (MCP) 實現，可通過 TypeScript SDK 訪問 Google Analytics 4 (GA4) 數據。以下是使用該服務器的基本步驟：

先決條件

• Node.js 20 或更高版本
• Google Analytics 4 賬戶屬性
• 啟用了 Analytics Data API 的 Google Cloud 項目
• 具備相應權限的服務賬戶憑據

安裝

pnpm install mcp-server-google-analytics

啟動服務器

pnpm start

在 Claude Desktop 中的配置

在你的 Claude Desktop 配置中添加以下內容：

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

✨ 主要特性

• 獲取可自定義維度的頁面視圖指標：能夠根據需求自定義維度，精準獲取頁面視圖指標。
• 跟蹤一段時間內的活躍用戶和新用戶：方便了解用戶增長和留存情況。
• 分析特定事件及其指標：深入分析特定事件，掌握事件相關數據。
• 監控用戶行為指標（會話時長、跳出率）：全面瞭解用戶行為，優化用戶體驗。
• 所有查詢支持靈活的時間範圍選擇：可根據不同需求選擇合適的時間範圍進行查詢。

💻 使用示例

基礎用法

本服務器提供了多個可用功能，以下是部分功能的使用示例：

getPageViews

獲取特定時間段內的頁面視圖指標：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // 可選
}

getActiveUsers

獲取活躍用戶指標：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

getEvents

獲取事件指標：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // 可選
}

getUserBehavior

獲取用戶行為指標：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

🔧 技術細節

安全注意事項

為確保服務器的安全性，使用時請遵循以下安全注意事項：

• 始終使用環境變量存儲敏感憑證：避免敏感信息洩露。
• 實施適當的 CORS 設置：防止跨域請求帶來的安全風險。
• 遵循最小權限原則設置服務賬戶權限：減少不必要的權限，降低安全風險。
• 定期輪換服務賬戶憑證：保證憑證的安全性。
• 監控 API 使用情況並根據需要實施速率限制：防止惡意請求。

🤝 為項目做貢獻

歡迎貢獻！請閱讀我們的 Contributing Guide 瞭解代碼規範和提交 Pull Request 的流程。

📄 許可證

本項目在 MIT License 下開源，具體信息請查看 LICENSE 文件。