Logly

Logly MCP 服务

通过 Claude、Cursor 或任何 Model Context Protocol 客户端查询你的 Logly 网站分析数据。

Logly 是一款以隐私为先的网站分析工具，体积不到 1 KB、无需 Cookie，并且从设计上符合 GDPR。此服务通过 MCP 提供你的分析数据，让 AI 助手能够回答“本周流量有什么变化？”或“注册漏斗的用户在哪一步流失？”等问题，甚至还能提供在新网站上安装 Logly 的代码片段。

要求

• Node.js 18 或更高版本
• Logly 账户和 API 密钥——在 Logly 控制台的设置 → API 密钥中创建。密钥格式类似 logly_a1b2c3...，且只会显示一次。

设置

此服务通过 npx 运行，无需安装。

Claude Desktop

编辑 claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "logly": {
      "command": "npx",
      "args": ["-y", "@logly-uk/mcp"],
      "env": { "LOGLY_API_KEY": "logly_your_key_here" }
    }
  }
}

重启 Claude Desktop。

Claude Code

claude mcp add logly -e LOGLY_API_KEY=logly_your_key_here -- npx -y @logly-uk/mcp

Cursor

将以下内容添加到项目中的 .cursor/mcp.json（或全局配置文件）：

{
  "mcpServers": {
    "logly": {
      "command": "npx",
      "args": ["-y", "@logly-uk/mcp"],
      "env": { "LOGLY_API_KEY": "logly_your_key_here" }
    }
  }
}

工具

工具	功能
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 许可。