MCP Google Analytics 4 Server

MCP谷歌分析4服务器

用于Google Analytics 4集成的全面模型上下文协议（MCP）服务器，为AI应用程序提供高级分析功能。

🎯 概述

此MCP服务器使AI应用程序能够通过标准化协议与Google Analytics 4进行交互。它支持数据检索、配置管理、合规性功能和商业智能自动化。

兼容性：适用于Cursor、Claude Desktop和任何兼容MCP的AI平台。

📊 特性

第一阶段：高级报告（8个工具）

• 基本指标：核心GA4指标和关键绩效指标
• 流量分析：来源、页面和用户行为
• 实时报告：实时数据（标准房产最长29分钟）
• 枢轴报告：交叉维度分析
• 漏斗分析：转换路径跟踪
• 批处理：多报告自动化

第2阶段：配置管理（13个工具）

• 自定义尺寸：创建、读取、更新、存档
• 自定义指标：完整的生命周期管理
• 转换事件：配置和管理目标
• 属性设置：全面的配置访问

第3阶段：平台集成（15个工具）

• Google广告：活动绩效和归因
• BigQuery 的：数据仓库连接
• 数据流：多平台跟踪设置
• 测量协议：服务器端事件跟踪

第四阶段：合规与隐私（10个工具）

• GDPR合规性：自动数据主体权利
• 用户删除：符合隐私要求的数据删除
• 数据保留：自动化生命周期管理
• 访问控制：许可和审计管理

第五阶段：商业智能（8种工具）

• 归因建模：多点触控归因分析
• 观众管理：自动分割
• 预测分析：基于机器学习的见解
• 自定义仪表板：自动报告

共计：5个阶段54个专用工具

🔧 安装

先决条件

• Python 3.8+
• 谷歌分析4属性
• 启用分析API的谷歌云项目

快速设置

1. 安装软件包:

pip install mcp-ga4-ultimate

1. 配置身份验证:

# Set up Application Default Credentials
gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/analytics.edit

1. 添加到您的MCP客户端:

对于光标 (.cursor/mcp.json):

{
  "mcpServers": {
    "ga4-ultimate": {
      "command": "python",
      "args": ["-m", "mcp_ga4_ultimate"],
      "env": {
        "GOOGLE_ANALYTICS_PROPERTY_ID": "your_property_id"
      }
    }
  }
}

适用于克劳德桌面 (claude_desktop_config.json):

{
  "mcpServers": {
    "ga4-ultimate": {
      "command": "python",
      "args": ["-m", "mcp_ga4_ultimate"],
      "env": {
        "GOOGLE_ANALYTICS_PROPERTY_ID": "your_property_id"
      }
    }
  }
}

🚀 使用示例

基本分析查询

"Show me the top 10 pages by traffic in the last 30 days"

实时监控

"What's happening on my website right now? Show active users and top content"

转换分析

"Analyze the funnel from landing page to purchase completion"

配置管理

"Create a custom dimension for tracking user engagement score"

GDPR合规性

"Process data deletion request for user ID abc123"

📋 API覆盖范围

此服务器实现了对Google Analytics API的全面覆盖：

API总覆盖率：54个专用工具

🔒 安全和权限

所需OAuth范围

• https://www.googleapis.com/auth/analytics.readonly -数据访问
• https://www.googleapis.com/auth/analytics.edit -配置管理
• https://www.googleapis.com/auth/analytics.manage.users -用户管理

数据隐私

• 本地未存储数据
• 仅限API直接通信
• 符合GDPR的数据处理
• 合规性审计日志

🧪 测试与验证

服务器包括全面的测试：

• 单元测试：所有54个工具均单独测试
• 集成测试：真正的API验证
• 成功率：92.3%（50/54个工具通过）
• 错误处理：优美的回退和详细的错误消息

运行测试：

python -m pytest tests/ -v

📖 文档

完整的API参考资料

• 工具文档 -所有54个工具详细信息
• 配置指南 -设置和定制
• 例子 -常见用例
• 故障排除 -常见问题

发展

• 贡献指南 -如何做出贡献
• 建筑 -技术设计
• 测试 -测试套件详细信息

🆚 与其他解决方案的比较

🤝 贡献

欢迎投稿！请查看我们的 贡献指南 了解详情。

开发设置

git clone https://github.com/your-org/mcp-ga4-ultimate.git
cd mcp-ga4-ultimate
pip install -e .[dev]

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 链接

• 谷歌分析4文档
• 模型上下文协议规范
• 问题追踪

📞 支持

• 文档: docs/
• 问题:
• 讨论:

______________________________________________________________________

备注：这是一个独立的实施。有关官方Google Analytics MCP服务器，请参阅 谷歌分析/谷歌分析mcp.