Google Analytics Data API MCP Server

Google Analytics Data API MCP Server

site icon
2025.04.09 0
JavaScript数据分析数据查询受众管理元数据访问开发效率数据库
Google Analytics Data API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Google Analytics Data API v1 交互。该服务提供了查询 Google Analytics 数据、管理受众和访问元数据的工具和资源。
View on GitHub

Overview

基本能力

产品定位

Google Analytics Data API MCP Server 是一个用于与 Google Analytics Data API v1 交互的服务,提供数据查询、受众管理和元数据访问功能。

核心功能

  • 运行标准和透视报告
  • 批量报告功能
  • 访问维度和指标的元数据
  • 创建、列出、更新和删除受众
  • 检查维度和指标的兼容性
  • 提供全面的资源端点以探索 GA 数据

适用场景

  • 数据分析师需要查询 Google Analytics 数据
  • 开发人员需要批量处理报告
  • 市场营销团队需要管理受众
  • 需要检查维度和指标兼容性的场景

工具列表

  • runReport: 运行标准报告
  • batchRunReports: 批量运行报告
  • runPivotReport: 运行透视报告
  • batchRunPivotReports: 批量运行透视报告
  • getMetadata: 获取元数据
  • checkCompatibility: 检查兼容性
  • createAudience: 创建受众
  • listAudiences: 列出受众
  • getAudience: 获取受众详情
  • deleteAudience: 删除受众
  • updateAudience: 更新受众

常见问题解答

  • 需要 Node.js 14 或更高版本
  • 需要 Google Analytics 4 属性
  • 需要具有适当权限的 Google Cloud 服务账户

使用教程

使用依赖

  • Node.js 14 或更高版本
  • Google Analytics 4 属性
  • Google Cloud 服务账户

安装教程

  1. 克隆仓库
  2. 安装依赖: npm install
  3. 创建 .env 文件,基于 .env.example 配置 Google Analytics 凭据: GOOGLE_CLIENT_EMAIL=your-service-account-email@project-id.iam.gserviceaccount.com GOOGLE_PRIVATE_KEY=your-private-key DEFAULT_PROPERTY_ID=properties/123456789

调试方式

  • 运行服务器: npm start
  • 使用 MCP Inspector 测试: npm run inspect

许可证

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