Googleanalytics MCP Server

一个基于MCP协议的Google Analytics数据API服务，提供报表查询、受众管理、元数据访问等功能。

营销研究与数据 #数据分析 #受众管理 #API服务 .JavaScript

评分 : 2分

下载量 : 6

更新时间 : 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}：获取特定受众群体的详细信息。