JinDaGe - mcp-server-google-analytics MCP Details

article

README

🚀 谷歌分析 MCP 服务器

这是一个基于模型上下文协议（Model Context Protocol）的 TypeScript SDK 实现的 MCP 服务器，可用于访问 Google Analytics 4 (GA4) 数据，助力用户深入分析网站或应用的各项数据指标。

🚀 快速开始

先决条件

Node.js 20 或更高版本
Google Analytics 4 属性
启用了 Analytics Data API 的 Google Cloud 项目
具备适当权限的服务账户凭证

安装配置

创建一个 Google Cloud 项目并启用 Analytics Data API。
创建服务账户并下载凭证 JSON 文件。
授予服务账户对您的 GA4 属性的访问权限。
设置环境变量：

export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"

安装方式

使用 Smithery 自动安装

通过 Smithery 自动安装 Google Analytics 服务器：

npx -y @smithery/cli install mcp-server-google-analytics --client claude

手动安装

pnpm install mcp-server-google-analytics

启动服务器

pnpm start

配置 Claude Desktop

在您的 Claude Desktop 配置中添加以下内容：

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

✨ 主要特性

获取可自定义维度的页面视图指标。
跟踪特定时间段内的活跃用户和新用户。
分析具体事件及其指标。
监控用户行为指标（会话时长、跳出率）。
支持灵活的时间范围选择，适用于所有查询。

💻 使用示例

基础用法

getPageViews

获取特定时间段内的页面视图指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // 可选参数
}

getActiveUsers

获取活跃用户指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

getEvents

获取事件指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // 可选参数
}

getUserBehavior

获取用户行为指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

📚 详细文档

安全注意事项

始终使用环境变量存储敏感凭证。
实施适当的 CORS 设置。
遵循最小权限原则设置服务账户权限。
定期轮换服务账户凭证。
监控 API 使用情况，必要时实施速率限制。

贡献指南

欢迎贡献！请阅读我们的贡献指南以了解如何参与。

mcp-server-google-analytics