AI导哈

Matomo数据分析服务

一个提供Matomo报告API访问的模型上下文协议（MCP）服务器，支持查询网站统计、访客信息和分析数据。

  • by kitconcept
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kitconcept/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

许可证

麻省理工学院

相关 MCP