MCP Server for Google Analytics 4

基本能力

产品定位

MCP Server for Google Analytics 4 是一个用于与Google Analytics 4数据交互的中间件，旨在为大型语言模型提供便捷的数据访问能力。

核心功能

• 运行可自定义维度、指标和日期范围的标准GA4报告
• 获取过去30分钟的实时数据
• 检索可用指标和维度的元数据
• 使用Google Cloud的Application Default Credentials进行安全认证
• 可通过Smithery轻松部署

适用场景

• 数据分析师需要快速获取GA4数据
• 开发人员需要将GA4数据集成到LLM应用中
• 需要实时监控网站或应用的用户活动

工具列表

1. run-report: 运行标准GA4报告，可配置指标、维度和日期范围。
2. run-realtime-report: 获取过去30分钟的实时数据。
3. get-metadata: 检索GA4属性可用的指标和维度。

常见问题解答

• 如何认证？使用gcloud auth application-default login进行认证。
• 如何设置GA4属性ID？可通过命令行参数或环境变量GA4_PROPERTY_ID设置。

使用教程

使用依赖

1. 创建Google Cloud项目
2. 启用Google Analytics Data API
3. 设置认证：

gcloud auth application-default login

安装教程

使用pip安装

pip install mcp-server-ga4

从源码安装

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

调试方式

启动服务器：

mcp-server-ga4 --property-id YOUR_GA4_PROPERTY_ID

环境变量

• GA4_PROPERTY_ID: 设置GA4属性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"]
        }
    }
}

许可证

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