Matomo Mcp Server By Openmost

Openmost Matomo MCP

与 Matomo 分析数据对话。 Openmost Matomo MCP 将 Claude（或任何兼容 MCP 的 AI 助手）连接到你的 Matomo 实例，让你只需提问，就能探索数据、创建报告并获取洞察。

“我的网站上周有多少次访问？与前一周相比如何？” “本月哪些页面的跳出率最高？” “显示昨天网站 #3 的热门引荐来源。”

👉 产品页面：openmost.com/matomo/extensions/matomo-mcp-client

✨ 什么是 Openmost Matomo MCP？

MCP（Model Context Protocol） 是一项开放标准，可让 AI 助手使用外部工具和数据源。Openmost Matomo MCP 是由 Openmost 构建的托管 MCP 服务，可让你的助手访问 Matomo 分析数据：

• 📊 分析流量：访问量、页面、引荐来源、营销活动、目标、转化……
• 🌐 管理网站：列出并探索 Matomo 中跟踪的网站。
• 🔔 使用提醒和报告：无需离开对话即可访问 Matomo 数据。
• 💬 内置提示词：现成的分析模板，帮助你快速获取有用的洞察。
• 🔄 始终保持最新：工具和提示词由 Openmost 服务提供，因此新功能会自动可用，无需在你的设备上更新任何内容。

它适用于 Matomo On-Premise 和 Matomo Cloud，你仍可使用自己的 Matomo 实例和权限。

架构

该服务由两部分组成：

1. Openmost Matomo MCP 服务（https://matomo-mcp.openmost.com），由 Openmost 托管。它提供 Matomo 工具和提示词，并通过 API 查询你的 Matomo 实例。
2. Matomo MCP 客户端（本代码库），一个在你的设备上运行的轻量级 Node.js 程序。Claude Desktop 会在本地启动它，并由它将请求转发到 Openmost 服务。

Claude Desktop  ⇄  Matomo MCP client (local)  ⇄  Openmost Matomo MCP server  ⇄  Your Matomo

ℹ️ 每次请求都会将你的 Matomo URL 和 API 令牌发送到 Openmost MCP 服务，以便它为你查询 Matomo。若要限制助手的访问权限，请使用仅具有 查看 权限的 Matomo 用户令牌。

✅ 要求

• Node.js 18 或更高版本
• Claude Desktop（或其他兼容 MCP 的客户端）
• 一个 Matomo 实例（On-Premise 或 Cloud）和一个 Matomo API 令牌
• 一个 Openmost MCP 令牌，可通过我们的联系表单按需获取

获取 Matomo API 令牌

在 Matomo 中，前往 Administration（⚙️）→ Personal → Security → Auth tokens，然后点击 Create new token。

🚀 安装

git clone https://github.com/openmost/matomo-mcp-client
cd matomo-mcp-client
npm install

记下 matomo-mcp-client.js 的绝对路径；你将在下一步中用到它：

pwd
# e.g. /Users/you/matomo-mcp-client  →  /Users/you/matomo-mcp-client/matomo-mcp-client.js

🔧 在 Claude Desktop 中配置

1. 打开配置文件

在 Claude Desktop 中，前往 Settings → Developer → Edit Config。你也可以直接打开该文件（如果文件不存在，请创建）：

2. 添加 MCP 服务

{
  "mcpServers": {
    "openmost-matomo-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/matomo-mcp-client/matomo-mcp-client.js",
        "--matomo-host=https://matomo.example.com",
        "--matomo-token=YOUR_MATOMO_TOKEN",
        "--openmost-token=YOUR_OPENMOST_TOKEN"
      ]
    }
  }
}

如果文件中已包含其他服务，请将 "openmost-matomo-mcp" 条目添加到现有的 "mcpServers" 对象中。

在 Windows 上，请转义路径中的反斜杠："C:\\Users\\you\\matomo-mcp-client\\matomo-mcp-client.js"。

{
  "mcpServers": {
    "openmost-matomo-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/matomo-mcp-client/matomo-mcp-client.js"],
      "env": {
        "MATOMO_HOST": "https://matomo.example.com",
        "MATOMO_TOKEN_AUTH": "YOUR_MATOMO_TOKEN",
        "OPENMOST_MCP_TOKEN": "YOUR_OPENMOST_TOKEN"
      }
    }
  }
}

3. 重启 Claude Desktop

完全退出 Claude Desktop（不要只关闭窗口），然后重新打开。

🎉 使用方法

重启后，打开一个新对话。openmost-matomo-mcp 应该会出现在消息框的工具菜单（🔨 / 连接器图标）中。然后只需提出问题：

• “列出我所有的 Matomo 站点。”
• “总结一下站点 1 上个月的流量。”
• “本季度哪些营销渠道带来了最多的转化？”

Claude 首次使用 Matomo 工具时会征求你的许可。

⚙️ 选项

每个选项都可以通过命令行参数或环境变量设置。命令行参数优先。

内置行为：

• 缓存：工具和提示词列表会缓存 5 分钟。
• 重试：失败的请求会采用指数退避方式重试。身份验证错误（401/403）不会重试。
• 启动检查：除非 NODE_ENV=production，否则客户端会在启动时测试服务是否可访问。

🩺 故障排除

在终端中检查配置。 如果有问题，客户端会打印明确的错误：

node matomo-mcp-client.js \
  --matomo-host=https://matomo.example.com \
  --matomo-token=YOUR_MATOMO_TOKEN \
  --openmost-token=YOUR_OPENMOST_TOKEN

如果配置有效，客户端会启动并等待 MCP 连接（按 Ctrl+C 停止）。

服务未出现在 Claude Desktop 中

• 检查 claude_desktop_config.json 是否为有效的 JSON（末尾不能有逗号）。
• 检查 matomo-mcp-client.js 的路径是否为正确的绝对路径。
• 确保完全退出并重新启动 Claude Desktop。

spawn node ENOENT 或“server disconnected” Claude Desktop 找不到 Node.js。这种情况常见于使用 nvm、asdf 或 Homebrew 时。运行 which node（macOS/Linux）或 where node（Windows），并将完整路径用作 "command"，例如 "/Users/you/.nvm/versions/node/v20.11.0/bin/node"。

身份验证错误（401 / 403 / Invalid token） 检查你的 Openmost 令牌，并确认 Matomo 令牌有效且有权访问所请求的站点。

日志 客户端会将日志写入 stderr。Claude Desktop 将日志保存在以下位置：

• macOS：~/Library/Logs/Claude/mcp-server-openmost-matomo-mcp.log
• Windows：%APPDATA%\Claude\logs\mcp-server-openmost-matomo-mcp.log

📖 资源

• Openmost Matomo MCP：产品页面
• Matomo Analytics
• Claude Desktop
• Model Context Protocol