Google Analytics Data API MCP 服务器

使用模型上下文协议 (MCP) 服务器来提供访问 Google Analytics Data API 的接口。

功能

此 MCP 服务器提供用于访问 Google Analytics Data API 主要功能的工具和资源：

工具

• get_report: 基于指定的日期范围、指标和维度获取报告
• get_realtime_data: 获取实时数据

资源

• ga4://property/{propertyId}/metadata: 访问 Google Analytics 属性的元数据

设置

前提条件

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="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 Desktop 的配置文件中：

{
  "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 使用例。

许可证

MIT