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许可证
麻省理工学院