Matomo分析查询工具

一个轻量级的MCP服务器,连接Claude Desktop到您的Matomo分析实例,允许通过自然语言查询Matomo分析数据。

  • by ProductPope
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ProductPope/matomoMCP

使用说明

matomoMCP

一个轻量级的MCP(模型上下文协议)服务器,将Claude Desktop连接到您的Matomo Analytics实例。

它做什么

允许您使用自然语言直接从Claude Desktop查询Matomo分析数据。在不打开浏览器的情况下,向克劳德询问访问量、跳出率、流量来源、转化率、事件等信息。

可用工具

  • 访客_总结 --访问量、跳出率、平均停留时间、页面浏览量
  • 独特访客 --随时间推移的独特访客
  • 目标列表 --列出所有已配置的目标
  • 目标_转换 --转化率和每个目标的收入
  • 事件_类别 --按类别分组的事件
  • 事件_动作 --按动作分组的事件
  • 事件_名称 --按名称分组的事件
  • top_pages --访问量最大的页面(URL)
  • top_page_titles --访问量最大的页面(标题)
  • entry_page --着陆页
  • exit_pages --退出页面
  • 参考文献概述 --交通源概述
  • 推荐人_网站 --来自外部网站的流量
  • 推荐人_活动 --UTM活动流量
  • 推荐人搜索 --搜索引擎关键词
  • 设备 --台式机/手机/平板电脑故障
  • 浏览器 --浏览器使用情况
  • 国家 --游客国家
  • 所有_站点 --所有Matomo网站的概述
  • ab_实验 --A/B实验(需要AbTesting插件)

需求

  • Node.js v18+
  • 克劳德桌面
  • 具有API访问权限的正在运行的Matomo实例

安装

1.克隆存储库

git clone https://github.com/ProductPope/matomoMCP.git
cd matomoMCP

2.安装依赖项

npm install

3.配置克劳德桌面

打开您的Claude Desktop配置文件:

  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

将以下内容添加到 mcpServers 章节:

{
  "mcpServers": {
    "matomo": {
      "command": "node",
      "args": ["C:\\path\\to\\matomoMCP\\index.js"],
      "env": {
        "MATOMO_URL": "https://your-matomo-instance.com",
        "MATOMO_TOKEN": "your_token_auth_here"
      }
    }
  }
}

替换:

  • C:\\path\\to\\matomoMCP\\index.js 带有克隆仓库的实际路径
  • https://your-matomo-instance.com 使用您的Matomo URL
  • your_token_auth_here 使用您的Matomo API令牌(可在Matomo的“管理”>“个人”>“安全”>“验证令牌”下找到)

4.设置默认站点ID

在 index.js,默认值 idSite 设置为 1。如果需要,请更改它以匹配您的Matomo站点ID。浏览仪表板时,您可以在Matomo URL中找到您的网站ID。

5.重新启动克劳德桌面

完全退出Claude Desktop(包括从系统托盘中退出)并重新启动。Matomo连接器应出现在 + >连接器。

用法示例

连接后,您可以问Claude:

  • “显示过去7天的访问摘要”
  • “本月最热门的登录页面是什么?”
  • “我的UTM活动本周表现如何?”
  • “过去4周的反弹率趋势如何?”
  • “显示上个月的目标转化率”

许可证

麻省理工学院