Matomo MCP

Matomo MCP服务器

模型上下文协议（MCP）服务器，提供对Matomo报告API的访问。

特性

• 通过MCP工具访问Matomo报告数据
• 查询网站统计数据、访问者信息和分析数据
• 支持多个Matomo站点
• 安全的API令牌身份验证

安装

pip install -e .

配置

服务器需要以下环境变量：

• MATOMO_URL：您的Matomo实例URL（例如。， https://analytics.example.com)
• MATOMO_TOKEN：您的Matomo API身份验证令牌

您可以通过以下方式从Matomo实例获取API令牌： 个人设置→ 安全→ 身份验证令牌

使用Claude Desktop

将此添加到您的Claude Desktop配置中：

MacOS

~/Library/Application Support/Claude/claude_desktop_config.json

视窗

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "matomo": {
      "command": "python",
      "args": ["-m", "matomo_mcp"],
      "env": {
        "MATOMO_URL": "https://your-matomo-instance.com",
        "MATOMO_TOKEN": "your_api_token_here"
      }
    }
  }
}

可用工具

get_site_info

获取有关特定Matomo网站的信息。

参数：

• site_id：站点的ID（整数）

get_visits_summary

获取某个日期范围内网站的访问摘要。

参数：

• site_id：站点的ID（整数）
• period：时间段（日、周、月、年、范围）
• date：日期或日期范围（例如，“2024-01-01”、“最近30”、“今天”）

get_page_urls

获取网站访问量最大的页面URL。

参数：

• site_id：站点的ID（整数）
• period：时间段（日、周、月、年、范围）
• date：日期或日期范围
• limit：最大结果数（默认值：10）

get_countries

按国家获取访客统计数据。

参数：

• site_id：站点的ID（整数）
• period：时间段（日、周、月、年、范围）
• date：日期或日期范围
• limit：最大结果数（默认值：10）

用户设置

获取访问者浏览器和设备信息。

参数：

• site_id：站点的ID（整数）
• period：时间段（日、周、月、年、范围）
• date：日期或日期范围

query_custom_report

执行自定义Matomo API查询。

参数：

• method：Matomo API方法（例如，“Actions.getPageUrls”）
• site_id：站点的ID（整数）
• period：时间段（日、周、月、年、范围）
• date：日期或日期范围
• additional_params：带有附加参数的可选JSON对象

发展

安装开发依赖项：

pip install -e ".[dev]"

运行测试：

pytest

许可证

麻省理工学院