Ganalytics MCP Server

🚀 谷歌分析 MCP 服务器

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

测试结果（2024-03-26）

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

✨ 主要特性

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

📦 安装指南

1. 克隆仓库。
2. 安装依赖项：

   npm install
   

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

   npm run build
   

📚 详细文档

设置谷歌分析凭证

1. 访问 Google Cloud Console。
2. 创建新项目或选择现有项目。
3. 启用 Google Analytics Data API。
4. 创建具有适当权限的服务账户。
5. 下载服务账户密钥（JSON 格式）。
6. 从 JSON 文件中提取客户端电子邮件和私钥。
7. 将这些内容添加到您的 .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 工具使用

基础用法

get_analytics_data 工具可用于获取带有可选过滤和分析的谷歌分析数据。 参数说明：

示例代码：

{
  "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

📄 许可证

[此处添加许可证信息]

贡献者

[此处列出贡献者]