Google Analytics Data API MCP Server

Google Analytics Data API MCP Server

site icon
2025.03.24 3
JavaScript数据分析报告生成Google Analytics金融服务开发效率
Google Analytics Data API MCP Server 是一个通过Model Context Protocol (MCP) 提供访问Google Analytics Data API接口的服务。它允许用户获取Google Analytics的数据报告和实时数据,以及访问Google Analytics属性的元数据。
View on GitHub

Overview

基本能力

产品定位

该MCP服务器提供访问Google Analytics Data API的接口,主要用于数据分析和报告生成。

核心功能

  • get_report: 根据指定的日期范围、指标和维度获取报告。
  • get_realtime_data: 获取实时数据。
  • ga4://property/{propertyId}/metadata: 访问Google Analytics属性的元数据。

适用场景

  • 网站流量分析
  • 用户行为分析
  • 实时数据监控
  • 数据报告生成

工具列表

  • get_report: 获取指定日期范围和维度的报告。
  • get_realtime_data: 获取实时用户数据。

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

  1. 创建Google Cloud项目并启用Analytics Data 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="[email protected]"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"

调试方式

# 启动服务器
npm start

# 或使用提供的脚本
./run-server.sh

Claude Desktop设置

在Claude Desktop的配置文件中添加以下内容:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/mcp-server-google-analytics/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "[email protected]",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款。