AI导哈

GA4数据分析服务

一个通过Google Analytics Data API使大型语言模型（LLMs）能够与Google Analytics 4（GA4）数据进行交互的模型上下文协议（MCP）服务器。

  • by harshfolio
  • Python
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 harshfolio/mcp-server-ga4

使用说明

用于谷歌分析的MCP服务器4

模型上下文协议（MCP）服务器，允许大型语言模型（LLM）通过Google Analytics data API与Google Analytics 4（GA4）数据交互。

特性

  • 运行具有可定制维度、指标和日期范围的标准GA4报告
  • 获取过去30分钟的实时数据
  • 检索有关可用度量和维度的元数据
  • 使用Google Cloud的应用程序默认凭据进行安全身份验证
  • 可配置，通过以下方式轻松部署 史密瑟里

安装

使用pip

pip install mcp-server-ga4

来源

git clone https://github.com/yourusername/mcp-server-ga4.git
cd mcp-server-ga4
pip install -e .

认证

此服务器使用Google Cloud的应用程序默认凭据（ADC）进行身份验证。在使用服务器之前，您需要：

  1. 创建Google Cloud项目
  2. 启用Google Analytics Data API
  3. 设置身份验证：
gcloud auth application-default login

有关更多详细信息，请参阅 谷歌云身份验证文档.

用法

命令行

使用GA4属性ID启动服务器：

mcp-server-ga4 --property-id YOUR_GA4_PROPERTY_ID

默认情况下，服务器将使用标准的MCP stdio传输。

环境变量

您还可以通过环境变量设置配置：

  • GA4_PROPERTY_ID：您的Google Analytics 4属性ID

与Claude Desktop一起使用

  1. 全局安装服务器： pip install mcp-server-ga4
  2. 设置您的Google Cloud身份验证： gcloud auth application-default login
  3. 编辑您的Claude Desktop配置：
{
    "mcpServers": {
        "ga4": {
            "command": "mcp-server-ga4",
            "args": ["--property-id", "YOUR_GA4_PROPERTY_ID"]
        }
    }
}

可用工具

运行报告

运行具有可配置指标、维度和日期范围的标准GA4报告。

参数：

  • property_id （可选）：GA4属性ID（覆盖默认值）
  • metrics：指标名称列表（例如，[“activeUsers”、“sessions”]）
  • dimensions （可选）：维度名称列表（例如，[“日期”、“国家”]）
  • date_range：以下格式之一的日期范围：
    • {"start_date": "YYYY-MM-DD", "end_date": "YYYY-MM-DD"}
    • "last7days", "last30days", "today", "yesterday"
  • limit （可选）：要返回的行数（默认值：10）

运行实时报告

获取过去30分钟的实时数据。

参数：

  • property_id （可选）：GA4属性ID（覆盖默认值）
  • metrics：指标名称列表（例如，[“activeUsers”、“screenPageViews”]）
  • dimensions （可选）：维度名称列表（例如，[“国家”、“城市”]）
  • limit （可选）：要返回的行数（默认值：10）

获取元数据

检索GA4属性的可用度量和维度。

参数：

  • property_id （可选）：GA4属性ID（覆盖默认值）
  • type （可选）：要检索的元数据类型("metrics", "dimensions"，或 "all"，默认值： "all")

例子

运行标准报告

What were the top 5 countries by active users in the last 30 days?

检查实时数据

How many users are currently active on the site?

获取元数据信息

What metrics are available for me to query in GA4?

发展

  1. 克隆存储库
  2. 安装开发依赖项： pip install -e ".[dev]"
  3. 运行测试： pytest

许可证

麻省理工学院

相关 MCP