Google Analytics MCP 服务器
用于访问 Google Analytics 4 (GA4) 数据的 MCP 服务器实现，使用模型上下文协议 TypeScript SDK 构建。
特征
获取具有可自定义维度的页面浏览量指标
跟踪一段时间内的活跃用户和新用户
分析特定事件及其指标
监控用户行为指标（会话时长、跳出率）
所有查询均可灵活选择日期范围
Related MCP server: Google Analytics Data API MCP Server
先决条件
Node.js 20 或更高版本
Google Analytics 4 媒体资源
已启用 Analytics Data API 的 Google Cloud 项目
具有适当权限的服务帐户凭据
设置
创建 Google Cloud 项目并启用 Analytics Data API
创建服务帐户并下载凭证 JSON 文件
授予服务帐号对您的 GA4 资源的适当访问权限
设置环境变量：
export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Google Analytics Server：
npx -y @smithery/cli install mcp-server-google-analytics --client claude
手动安装
pnpm install mcp-server-google-analytics
用法
启动服务器
pnpm start
Claude Desktop中的配置
将其添加到您的 Claude Desktop 配置中：
{
"mcpServers": {
"google-analytics": {
"command": "npx",
"args": ["-y", "mcp-server-google-analytics"],
"env": {
"GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
"GOOGLE_PRIVATE_KEY": "your-private-key",
"GA_PROPERTY_ID": "your-ga4-property-id"
}
}
}
}
可用函数
获取页面浏览量
获取特定日期范围内的页面浏览量指标：
{
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": ["page", "country"] // Optional
}
获取活跃用户
获取活跃用户指标：
{
"startDate": "2024-01-01",
"endDate": "2024-01-31"
}
获取事件
获取事件指标：
{
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"eventName": "purchase" // Optional
}
获取用户行为
获取用户行为指标：
{
"startDate": "2024-01-01",
"endDate": "2024-01-31"
}
安全注意事项
始终对敏感凭据使用环境变量
实施适当的 CORS 设置
设置服务帐户权限时遵循最小特权原则
定期轮换服务帐户凭据
监控 API 使用情况并根据需要实施速率限制
贡献
欢迎贡献代码！请阅读我们的贡献指南，详细了解我们的行为准则以及提交 Pull Request 的流程。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。