mcp

通过MCP协议连接Google Analytics数据API的工具

安装使用

复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：

帮我安装这个 AI Skill：mcp。
它的用途是：通过MCP协议连接Google Analytics数据API的工具
详细介绍见：https://321skill.com/skills/mcp-mcp-server-google-analytics/
请根据该页面的说明完成安装。

“帮我查询过去7天网站的用户来源渠道和会话数。”，它会通过此MCP服务器调用Google Analytics API，获取相应的维度和指标数据，并以清晰的表格或总结形式呈现给你。你还可以进一步要求：“对比一下本月和上月的用户参与度指标。”，它会执行两次查询并进行对比分析。

这个MCP服务器工具解决了开发者或数据分析师需要便捷、安全地访问Google Analytics数据的问题。传统上，获取GA数据需要编写复杂的API调用代码并处理认证流程，而该工具通过标准化的MCP协议，将GA数据API封装成易于调用的接口，大大简化了集成过程。

使用时，你需要先在Google Cloud Console创建项目并启用Analytics Data API，配置好服务账号和密钥文件。然后，通过MCP客户端（如Claude Desktop）加载此服务器，即可在AI助手中直接查询GA数据，例如请求特定时间段内的用户活跃度或页面浏览量报告。

它非常适合需要将网站或应用的用户行为数据纳入分析流程的角色，例如数据分析师、营销专员或全栈开发者。这些用户通常需要定期获取经营数据来分析营销效果、优化广告投放或进行趋势分析。

一个重要的使用建议是，务必妥善保管服务账号的密钥文件，并遵循最小权限原则，仅授予该服务账号访问必要数据视图（Property）的权限。同时，注意GA数据API可能有调用配额限制，在批量查询大量数据时需做好规划。

与通用数据抓取工具相比，它专为Google Analytics API设计，内置了正确的认证流程和数据模型映射；与其他GA客户端库相比，它通过MCP协议提供了与AI助手（如Claude）直接交互的统一接口，无需额外编写胶水代码。

不适合需要实时（秒级）监控或处理非Google Analytics数据源的场景。

需要哪些前提条件才能使用？

需要一个Google Cloud项目、已启用的Analytics Data API、一个服务账号及其密钥JSON文件，以及对目标GA4媒体资源的访问权限。

支持查询GA4的哪些数据？

支持通过GA Data API v1查询核心报告数据，如用户数、会话数、事件数、指标和维度组合等。