内容
# Logly MCP 服务器
在 Claude、Cursor 或任何 [模型上下文协议](https://modelcontextprotocol.io) 客户端中查询您的 [Logly](https://logly.uk) 网络分析。
Logly 是一款优先考虑隐私的网络分析工具 — 小于 1 KB，无 cookie，GDPR 合规设计。此服务器通过 MCP 公开您的分析数据，以便 AI 助手可以回答诸如 *"这周流量如何变化？"* 或 *"我的注册流程在哪里流失用户？"* 之类的问题 — 甚至可以为您提供新站点的安装代码。
## 要求
- Node.js 18 或更新版本
- Logly 账户和 API 密钥 — 在您的 [Logly 控制面板](https://app.logly.uk) 中 **设置 → API 密钥** 下创建。密钥类似于 `logly_a1b2c3...`，仅显示一次。
## 设置
服务器通过 `npx` 运行 — 无需安装步骤。
### Claude 桌面版
编辑 `claude_desktop_config.json`（设置 → 开发者 → 编辑配置）：
```json
{
"mcpServers": {
"logly": {
"command": "npx",
"args": ["-y", "@logly-uk/mcp"],
"env": { "LOGLY_API_KEY": "logly_您的密钥_在此" }
}
}
}
```
重启 Claude 桌面版。
### Claude 代码
```bash
claude mcp add logly -e LOGLY_API_KEY=logly_您的密钥_在此 -- npx -y @logly-uk/mcp
```
### Cursor
添加到项目中的 `.cursor/mcp.json`（或全局）：
```json
{
"mcpServers": {
"logly": {
"command": "npx",
"args": ["-y", "@logly-uk/mcp"],
"env": { "LOGLY_API_KEY": "logly_您的密钥_在此" }
}
}
}
```
## 工具
| 工具 | 功能 |
|---|---|
| `logly_list_sites` | 列出您账户中的每个站点及其站点 ID — 从这里开始。 |
| `logly_stats` | 页面浏览量、会话数、访客数、跳出率、平均持续时间、每日序列、上一时期比较。 |
| `logly_breakdown` | 顶部页面、来源、国家和设备/浏览器分布。 |
| `logly_realtime` | 当前活跃的访客。 |
| `logly_events` | 自定义事件计数。 |
| `logly_funnels` | 列出站点的转化漏斗及其步骤。 |
| `logly_funnel_results` | 每个漏斗步骤的完成计数和流失率。 |
| `logly_install_snippet` | 添加 Logly 到站点 `<head>` 的 `<script>` 标签。 |
### 日期筛选
统计工具接受 `days` 窗口（7、30 或 90 — 默认 30）或明确的 `from` / `to` 对（`YYYY-MM-DD`）。如果两者都给定，则 `from` / `to` 生效。
## 环境变量
| 变量 | 是否必需 | 用途 |
|---|---|---|
| `LOGLY_API_KEY` | 是 | 您的 Logly API 密钥。 |
| `LOGLY_API_BASE` | 否 | 重写 API 基础 URL（默认为 `https://app.logly.uk`）。 |
## 链接
- Logly — <https://logly.uk>
- MCP 服务器页面 — <https://logly.uk/mcp/>
- 公共 API 参考 — <https://logly.uk/docs>
MIT 许可。
