MCP Server Google Analytics

🚀 谷歌分析 MCP 服務器

這是一個基於模型上下文協議（Model Context Protocol）的 TypeScript SDK 實現的 MCP 服務器，可用於訪問 Google Analytics 4 (GA4) 數據，助力用戶深入分析網站或應用的各項數據指標。

🚀 快速開始

先決條件

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

安裝配置

1. 創建一個 Google Cloud 項目並啟用 Analytics Data API。
2. 創建服務賬戶並下載憑證 JSON 文件。
3. 授予服務賬戶對您的 GA4 屬性的訪問權限。
4. 設置環境變量：

export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"

安裝方式

使用 Smithery 自動安裝

通過 Smithery 自動安裝 Google Analytics 服務器：

npx -y @smithery/cli install mcp-server-google-analytics --client claude

手動安裝

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 使用情況，必要時實施速率限制。

貢獻指南

歡迎貢獻！請閱讀我們的 貢獻指南 以瞭解如何參與。

相關文件

• LICENSE
• README.md
• CONTRIBUTING.md