Ganalytics MCP Server

🚀 谷歌分析 MCP 服务器

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

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

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

🚀 快速开始

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

✨ 主要特性

• 可通过 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

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

参数：

示例：

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

📚 详细文档

可用资源

指标

维度

🔧 技术细节

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

npm test

📄 许可证

[此处添加许可证信息]

贡献者

[此处列出贡献者]