mcp-server-google-analytics

🚀 谷歌分析数据API MCP 服务器

谷歌分析数据API MCP 服务器为访问谷歌分析数据API提供了便捷的接口，帮助用户更高效地获取和处理分析数据。

🚀 快速开始

在使用该MCP服务器之前，你需要完成一系列的设置步骤。首先，你要创建谷歌云项目并启用分析数据API，接着创建服务账户并下载认证信息JSON文件，最后为服务账户授与访问相应GA4属性的权限。详细设置指南请参阅设置指南。

完成设置后，进行安装操作：

# 克隆仓库
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics

# 安装依赖项
npm install

# 构建
npm run build

还需要设置环境变量：

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"

✨ 主要特性

此MCP服务器提供了访问谷歌分析数据API主要功能的工具和资源：

工具

• get_report：根据指定日期范围、指标、维度获取报告
• get_realtime_data：获取实时数据

资源

• ga4://property/{propertyId}/metadata：访问谷歌分析属性的元数据

📦 安装指南

先决条件

1. 创建谷歌云项目并启用分析数据API
2. 创建服务账户并下载认证信息JSON文件
3. 为服务账户授与访问相应GA4属性的权限

详细设置指南请参阅设置指南。

安装步骤

# 克隆仓库
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics

# 安装依赖项
npm install

# 构建
npm run build

环境变量配置

需要设置以下环境变量：

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"

💻 使用示例

启动服务器

npm start

或使用提供的脚本：

./run-server.sh

Claude Desktop 设置

在Claude桌面配置文件中添加以下内容：

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/mcp-server-google-analytics/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

详细配置示例请参阅claude-desktop-config-sample.json。

工具使用示例

基础用法

使用get_report工具获取过去7天的活跃用户数和页面浏览量：

{
  "startDate": "7daysAgo",
  "endDate": "today",
  "metrics": ["activeUsers", "screenPageViews"],
  "dimensions": ["date"],
  "limit": 10
}

高级用法

使用get_realtime_data工具获取当前活跃用户数：

{
  "metrics": ["activeUsers"],
  "dimensions": ["deviceCategory"],
  "limit": 10
}

资源使用示例

基础用法

访问以下资源以检查可用的指标和维度：

ga4://property/123456789/metadata

Claude中的使用示例

Claude中的使用示例请参阅Claude使用示例。

📄 许可证

本项目采用MIT许可证。