关键词

Google AnalyticsGA4网站分析数据查询LLM工具

Google Analytics MCP Server 使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为LLM应用提供访问 Google Analytics 4 (GA4) 数据的能力。通过此服务器，LLM可以调用预定义工具来查询GA4的各种指标，例如页面浏览量、活跃用户、事件数据和用户行为等，从而将网站分析数据融入到LLM的上下文理解和生成过程中。

主要功能点

  • GA4 数据访问: 提供对 Google Analytics 4 数据的安全访问接口。
  • 多种数据查询工具: 内置多种工具，用于查询页面浏览量、活跃用户、事件数据和用户行为等关键GA4指标。
  • 灵活的日期范围: 所有数据查询工具均支持自定义日期范围。
  • 可配置的环境变量: 通过环境变量管理Google Analytics 4 的认证信息和属性ID，保证安全性和灵活性。

安装步骤

  1. 确保已安装 Node.js 20 或更高版本。
  2. 确保已创建 Google Cloud 项目并启用 Analytics Data API。
  3. 创建服务帐户并下载凭据 JSON 文件。
  4. 授予服务帐户对您的 GA4 媒体资源的适当访问权限。
  5. 设置以下环境变量（请在运行服务器的环境中设置，而不是MCP客户端配置中）： 
    export GOOGLE_CLIENT_EMAIL="[email protected]"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"
  6. 使用 'pnpm install mcp-server-google-analytics' 命令安装项目。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加以下服务器配置信息。客户端会使用这些信息来启动和连接到服务器。

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"]
    }
  }
}
  • 'server name': 'google-analytics' (服务器名称，客户端用此名称引用)
  • 'command': 'npx' (启动服务器的命令，通常是Node.js的包执行器)
  • 'args': '["-y", "mcp-server-google-analytics"]' (传递给 'command' 的参数，这里 '-y' 用于跳过 'npx' 的确认提示，'mcp-server-google-analytics' 是要执行的包名)

注意: 客户端的环境变量配置应在其自身的配置中完成，而不是在服务器配置中。服务器的环境变量（如 'GOOGLE_CLIENT_EMAIL', 'GOOGLE_PRIVATE_KEY', 'GA_PROPERTY_ID'）需要在运行服务器的环境中设置。

基本使用方法

  1. 启动服务器：在项目根目录下运行 'pnpm start' 命令。
  2. 在 MCP 客户端（如 Claude Desktop）中配置并连接到 'google-analytics' 服务器。
  3. 在 LLM 对话中，可以使用自然语言指示 LLM 调用 'google-analytics' 服务器提供的工具来查询 GA4 数据。例如，您可以指示 LLM "查询上个月网站的页面浏览量" 或 "获取最近一周的活跃用户数"。LLM 将根据您的指示，调用相应的工具并返回 GA4 数据。

信息

分类

商业系统

访问项目