Google Analytics MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过工具和资源提供对 Google Analytics 数据的访问。

测试结果 (2024-03-26):

• 总活跃用户数: 102,883
• 白俄罗斯活跃用户数: 64,837 (63%)
• 总页面浏览量: 2,422,925
• 白俄罗斯页面浏览量: 1,950,160 (80%)

功能

• 通过 MCP 资源访问 Google Analytics 指标和维度
• 使用灵活的过滤选项获取分析数据
• 获取带有见解和建议的格式化数据
• 使用强类型 TypeScript 实现

安装

1. 克隆存储库
2. 安装依赖

   npm install
   

3. 基于 .env.example 创建一个 .env 文件，并填写您的 Google Analytics 凭据
4. 构建项目

   npm run build
   

设置 Google Analytics 凭据

1. 前往 Google Cloud Console
2. 创建一个新项目或选择一个现有项目
3. 启用 Google Analytics Data API
4. 创建具有适当权限的服务帐户
5. 下载服务帐户密钥（JSON 格式）
6. 从 JSON 文件中提取客户端电子邮件和私钥
7. 将它们添加到您的 .env 文件中：

   GA_PROPERTY_ID=您的_property_id
   GA_CLIENT_EMAIL=您的服务帐户@您的项目.iam.gserviceaccount.com
   GA_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\n您的私钥\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": "您的_property_id",
        "GA_CLIENT_EMAIL": "您的服务帐户@您的项目.iam.gserviceaccount.com",
        "GA_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\n您的私钥\\n-----END PRIVATE KEY-----"
      }
    }
  }
}

可用工具

get_analytics_data

获取 Google Analytics 数据，带有可选的过滤和分析。

参数：

• metrics (必需): 要获取的指标名称数组
• dimensions (可选): 维度名称数组
• startDate (必需): 开始日期，格式为 YYYY-MM-DD
• endDate (必需): 结束日期，格式为 YYYY-MM-DD
• filters (可选): 包含指标和维度过滤器的对象
• orderBy (可选): 要排序的字段数组
• limit (可选): 要返回的记录数
• offset (可选): 要返回的第一条记录的索引

示例：

{
  "metrics": ["activeUsers", "newUsers"],
  "dimensions": ["country", "deviceCategory"],
  "startDate": "2023-01-01",
  "endDate": "2023-01-31",
  "filters": {
    "metrics": [
      {
        "metric": "activeUsers",
        "operation": "GREATER_THAN",
        "value": 10
      }
    ],
    "dimensions": [
      {
        "dimension": "country",
        "operation": "EXACT",
        "value": "United States"
      }
    ]
  },
  "orderBy": [
    {
      "field": "activeUsers",
      "desc": true
    }
  ],
  "limit": 10
}

可用资源

analytics://metrics

可用 Google Analytics 指标列表。

analytics://dimensions

可用 Google Analytics 维度列表。

analytics://reports/{reportId}

访问特定的分析报告数据。

开发

运行测试

npm test

构建

npm run build

许可证

MIT