JinDaGe - GAnalytics-MCP-server MCP Details

article

README

🚀 谷歌分析 MCP 服务器

谷歌分析 MCP 服务器是一个借助工具和服务，为用户提供对谷歌分析数据访问功能的模型上下文协议（MCP）服务器。

2024 年 3 月 26 日的测试结果如下：

总活跃用户数：102,883
白俄罗斯活跃用户数：64,837（占比 63%）
总页面浏览量：2,422,925
白俄罗斯页面浏览量：1,950,160（占比 80%）

🚀 快速开始

谷歌分析 MCP 服务器允许你通过 MCP 资源访问谷歌分析指标和维度，还能使用灵活的过滤选项获取分析数据，并且获取格式化数据时会附带见解和建议。该服务器基于 TypeScript 实现，带有强类型。

✨ 主要特性

可通过 MCP 资源访问谷歌分析指标和维度。
支持使用灵活的过滤选项获取分析数据。
能够获取格式化数据，并附带见解和建议。
基于 TypeScript 实现，具备强类型特性。

📦 安装指南

克隆仓库。
安装依赖项：

npm install

根据 .env.example 创建一个 .env 文件，并添加您的谷歌分析凭证。
构建项目：

npm run build

🔧 设置谷歌分析凭证

访问 Google Cloud Console。
创建新项目或选择现有项目。
启用 Google Analytics Data API。
创建具有适当权限的服务账户。
下载服务账户密钥（JSON 格式）。
从 JSON 文件中提取客户端电子邮件和私钥。
将这些内容添加到您的 .env 文件中：

GA_PROPERTY_ID=your_property_id
GA_CLIENT_EMAIL=your-service-account@your-project.iam.gserviceaccount.com
GA_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nYourPrivateKeyHere\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": "your_property_id",
        "GA_CLIENT_EMAIL": "your-service-account@your-project.iam.gserviceaccount.com",
        "GA_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\nYourPrivateKeyHere\\n-----END PRIVATE KEY-----"
      }
    }
  }
}

高级用法

get_analytics_data

获取带有可选过滤和分析的谷歌分析数据。

参数： | 参数 | 详情 | 是否必需 | |------|------|------| | metrics | 要获取的指标名称数组 | 是 | | dimensions | 维度名称数组 | 否 | | startDate | 起始日期，格式为 YYYY - MM - DD | 是 | | endDate | 结束日期，格式为 YYYY - MM - DD | 是 | | filters | 包含指标和维度过滤器的对象 | 否 | | orderBy | 按字段排序的数组 | 否 | | limit | 要返回的记录数 | 否 | | offset | 要返回的第一条记录的索引 | 否 |

示例：

{
  "metrics": ["activeUsers", "newUsers"],
  "dimensions": ["country", "deviceCategory"],
  "startDate": "2024-03-26",
  "endDate": "2024-03-26",
  "filters": {
    "dimensionFilter": {
      "dimension": "country",
      "value": "US"
    }
  },
  "orderBy": ["activeUsers desc"],
  "limit": 10,
  "offset": 0
}

📚 详细文档

可用资源

指标

| 指标 | 详情 | |------|------| | activeUsers | 活跃用户数 | | newUsers | 新用户数 | | pageviews | 页面浏览量 | | sessions | 会话数 | | bounceRate | 跳出率 |

维度

| 维度 | 详情 | |------|------| | country | 国家/地区 | | deviceCategory | 设备类别 | | platform | 平台 | | mobileDeviceModel | 移动设备型号 | | os | 操作系统 |

🔧 技术细节

要运行测试，请执行以下命令：

npm test

📄 许可证

[此处添加许可证信息]

贡献者

[此处列出贡献者]

GAnalytics-MCP-server