内容
# gizmoanalytics-mcp
<img src="https://gizmoanalytics.io/logo.png" alt="Gizmo 分析" width="96" height="96" align="right" />
Gizmo 分析的 MCP 服务器 — 无需 cookie 的网站分析，具备 28 种工具的 MCP 接口（安装流程如 `setup_analytics_for_site` 和 `verify_install`，分析师级别的组合如 `summarize_all_sites` 和 `explain_traffic_change`，以及所有维度可筛选的查询基础）。
服务器 **托管** 在 `https://gizmoanalytics.io/mcp`。此仓库是公共所有权标记 + 文档（README、工具清单、许可证）用于 MCP 目录（MCP 注册表、Smithery、Glama、MCP.so）。无需本地安装或运行 — 将您的 IDE 指向托管端点即可。
## 连接
### 自动发现（Cursor、Claude Desktop、Windsurf 等）
在您的 IDE 的 MCP 设置中，添加一个新服务器，网址为：
```
https://gizmoanalytics.io/mcp
```
IDE 将通过 RFC 9728 元数据发现身份验证服务器，打开 OAuth 同意浏览器标签页，并存储生成的令牌。无需粘贴 API 密钥，无需编辑配置文件。
### 手动配置
如果您的 IDE 尚不支持 OAuth 感知 MCP 发现，请将其粘贴到客户端的 MCP 配置文件（Claude Desktop 等）：
```json
{
"mcpServers": {
"gizmoanalytics": {
"url": "https://gizmoanalytics.io/mcp",
"headers": {
"Authorization": "Bearer ak_admin_<您的管理员密钥>"
}
}
}
}
```
在 <https://gizmoanalytics.io/dashboard/keys> 获取管理员密钥。
## 您能询问的内容
```
"昨天流量为什么下降？"
"哪个网站增长最快？"
"将 foo.com 添加到 Gizmo 并安装跟踪器"
"在此按钮上跟踪注册事件"
"上季度德国的热门页面"
```
## 工具
- **安装流程**（楔形 — 任何安装请求时首先调用此）：`setup_analytics_for_site` 将网站创建 + 框架感知代码片段 + 粘贴目标文件路径 + 下一步计划捆绑到一个调用中。`verify_install` 通过获取首页确认脚本正在加载。
- **其他设置**：`create_site`、`get_install_snippet`、`get_event_tracking_snippet`、`get_badge_snippet`、`add_site_tags`、`goals` 和 `funnels`。
- **工作流程**（高级问题）：`summarize_all_sites`、`rank_sites_by_growth`、`identify_dead_sites`、`detect_anomalies`、`explain_traffic_change`。
- **查询基础**：`get_workspace_overview`、`get_site_traffic`、`get_top_pages`、`get_top_referrers`、`get_breakdown`（任意国家 / 浏览器 / 设备 / 渠道 / AI 来源 / 城市 / 等）、`get_time_series`、`query_events`、`breakdown_by_property`。所有支持堆叠过滤器（`country=US AND device=mobile`）和自定义日期范围。
参见 [TOOLS.md](./TOOLS.md) 以获取完整的清单和描述（自动从实时 `tools/list` 端点生成）。
完整文档：<https://gizmoanalytics.io/mcp-analytics>
## 许可证
MIT
