Eno Graph MCP Server Google Analytics

🚀 谷歌分析數據API MCP服務器

谷歌分析數據API MCP服務器提供了訪問Google Analytics Data API的接口，讓用戶能夠便捷地獲取谷歌分析數據，滿足數據查詢和分析的需求。

🚀 快速開始

在使用谷歌分析數據API MCP服務器之前，你需要完成一系列準備工作，包括創建Google Cloud項目、啟用API、創建服務賬戶等。完成準備工作後，進行安裝、配置環境變量，最後啟動服務器。

✨ 主要特性

此MCP服務器提供了訪問Google Analytics Data API主要功能的工具和資源：

工具

• get_report：基於指定日期範圍、指標和維度獲取報告。
• get_realtime_data：獲取即時數據。

資源

• ga4://property/{propertyId}/metadata：訪問Google Analytics屬性的元數據。

📦 安裝指南

安裝前準備

先決條件

1. 創建Google Cloud項目並啟用Analytics Data API。
2. 創建服務賬戶並下載認證信息JSON文件。
3. 為服務賬戶授與GA4屬性的適當訪問權限。

有關詳細安裝步驟，請參閱安裝指南。

安裝

# 克隆倉庫
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics

# 安裝依賴項
npm install

# 構建
npm run build

環境變量配置

需要設置以下環境變量：

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"

服務器啟動

npm start

或使用提供的腳本：

./run-server.sh

Claude Desktop配置

在Claude Desktop的設置文件中添加以下內容：

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/mcp-server-google-analytics/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

有關詳細配置示例，請參閱claude-desktop-config-sample.json。

💻 使用示例

工具使用示例

基礎用法

獲取報告

使用get_report工具獲取過去7天的活躍用戶數和頁面瀏覽量：

{
  "startDate": "7daysAgo",
  "endDate": "today",
  "metrics": ["activeUsers", "screenPageViews"],
  "dimensions": ["date"],
  "limit": 10
}

獲取即時數據

使用get_realtime_data工具獲取當前活躍用戶數：

{
  "metrics": ["activeUsers"],
  "dimensions": ["deviceCategory"],
  "limit": 10
}

資源使用示例

基礎用法

訪問以下資源以檢查可用的指標和維度：

ga4://property/123456789/metadata

示例用途

有關Claude中的使用示例，請參閱Claude使用示例。

📄 許可證

本項目採用MIT許可證。