Matomo MCP Server

MCP (Model Context Protocol) server để quản trị Matomo Analytics. Server này cung cấp các công cụ để tương tác với Matomo API thông qua giao diện MCP.

Tính năng

Quản lý Sites

Lấy danh sách tất cả sites
Lấy thông tin chi tiết của một site
Thêm site mới
Cập nhật thông tin site
Xóa site

Quản lý Users

Lấy danh sách tất cả users
Lấy thông tin chi tiết của một user
Thêm user mới
Cập nhật thông tin user
Xóa user
Thiết lập quyền truy cập cho user

Quản lý Goals

Lấy danh sách goals của site
Thêm goal mới
Cập nhật goal
Xóa goal

Quản lý Segments

Lấy danh sách segments
Thêm segment mới
Cập nhật segment
Xóa segment

Báo cáo Analytics

Tổng quan lượt truy cập
Top pages được truy cập nhiều nhất
Top keywords
Top referrers
Visitor log

Quản lý Hệ thống

Thông tin hệ thống
Quản lý plugins
Kích hoạt/vô hiệu hóa plugins

Cài đặt

Clone repository:

git clone <repository-url>
cd matomo-mcp

Cài đặt dependencies:

npm install

Build project:

npm run build

Cấu hình

Tạo file .env trong thư mục gốc:

MATOMO_BASE_URL=https://your-matomo-instance.com
MATOMO_TOKEN_AUTH=your-api-token

Sử dụng

Chạy server:

npm start

Chạy trong chế độ development:

npm run dev

Các Tools có sẵn

1. matomo_connect

Kết nối đến Matomo instance.

Tham số:

baseUrl: URL của Matomo instance
tokenAuth: Token xác thực API

2. matomo_get_sites

Lấy danh sách tất cả sites.

3. matomo_get_site

Lấy thông tin chi tiết của một site.

Tham số:

siteId: ID của site

4. matomo_add_site

Thêm site mới.

Tham số:

name: Tên site
urls: Danh sách URLs
timezone: Múi giờ (tùy chọn, mặc định: UTC)

5. matomo_get_users

Lấy danh sách tất cả users.

6. matomo_add_user

Thêm user mới.

Tham số:

userLogin: Tên đăng nhập
email: Email
password: Mật khẩu
alias: Bí danh (tùy chọn)

7. matomo_get_goals

Lấy danh sách goals của site.

Tham số:

siteId: ID của site

8. matomo_add_goal

Thêm goal mới.

Tham số:

siteId: ID của site
name: Tên goal
description: Mô tả
matchAttribute: Thuộc tính khớp
pattern: Mẫu khớp
patternType: Loại mẫu

9. matomo_get_visits_summary

Lấy tổng quan lượt truy cập.

Tham số:

siteId: ID của site
date: Ngày (YYYY-MM-DD)
period: Chu kỳ (day, week, month, year)

10. matomo_get_top_pages

Lấy top pages.

Tham số:

siteId: ID của site
date: Ngày (YYYY-MM-DD)
period: Chu kỳ (tùy chọn)
limit: Số lượng kết quả (tùy chọn)

11. matomo_get_system_info

Lấy thông tin hệ thống.

Ví dụ sử dụng

Kết nối đến Matomo:

{
  "name": "matomo_connect",
  "arguments": {
    "baseUrl": "https://analytics.example.com",
    "tokenAuth": "your-api-token"
  }
}

Lấy danh sách sites:

{
  "name": "matomo_get_sites",
  "arguments": {}
}

Thêm site mới:

{
  "name": "matomo_add_site",
  "arguments": {
    "name": "My Website",
    "urls": ["https://example.com", "https://www.example.com"],
    "timezone": "Asia/Ho_Chi_Minh"
  }
}

Lưu ý

Đảm bảo bạn có quyền truy cập API với token xác thực hợp lệ
Một số chức năng có thể yêu cầu quyền admin
Luôn kiểm tra kết nối trước khi sử dụng các tools khác

Đóng góp

Mọi đóng góp đều được chào đón! Vui lòng tạo issue hoặc pull request.

License

MIT License

Matomo MCP Server

MCP (Model Context Protocol) server để quản trị Matomo Analytics. Server này cung cấp các công cụ để tương tác với Matomo API thông qua giao diện MCP.

Tính năng

Quản lý Sites

Lấy danh sách tất cả sites
Lấy thông tin chi tiết của một site
Thêm site mới
Cập nhật thông tin site
Xóa site

Quản lý Users

Lấy danh sách tất cả users
Lấy thông tin chi tiết của một user
Thêm user mới
Cập nhật thông tin user
Xóa user
Thiết lập quyền truy cập cho user

Quản lý Goals

Lấy danh sách goals của site
Thêm goal mới
Cập nhật goal
Xóa goal

Quản lý Segments

Lấy danh sách segments
Thêm segment mới
Cập nhật segment
Xóa segment

Báo cáo Analytics

Tổng quan lượt truy cập
Top pages được truy cập nhiều nhất
Top keywords
Top referrers
Visitor log

Quản lý Hệ thống

Thông tin hệ thống
Quản lý plugins
Kích hoạt/vô hiệu hóa plugins

Cài đặt

Clone repository:

git clone <repository-url>
cd matomo-mcp

Cài đặt dependencies:

npm install

Build project:

npm run build

Cấu hình

Tạo file .env trong thư mục gốc:

MATOMO_BASE_URL=https://your-matomo-instance.com
MATOMO_TOKEN_AUTH=your-api-token

Sử dụng

Chạy server:

npm start

Chạy trong chế độ development:

npm run dev

Các Tools có sẵn

1. matomo_connect

Kết nối đến Matomo instance.

Tham số:

baseUrl: URL của Matomo instance
tokenAuth: Token xác thực API

2. matomo_get_sites

Lấy danh sách tất cả sites.

3. matomo_get_site

Lấy thông tin chi tiết của một site.

Tham số:

siteId: ID của site

4. matomo_add_site

Thêm site mới.

Tham số:

name: Tên site
urls: Danh sách URLs
timezone: Múi giờ (tùy chọn, mặc định: UTC)

5. matomo_get_users

Lấy danh sách tất cả users.

6. matomo_add_user

Thêm user mới.

Tham số:

userLogin: Tên đăng nhập
email: Email
password: Mật khẩu
alias: Bí danh (tùy chọn)

7. matomo_get_goals

Lấy danh sách goals của site.

Tham số:

siteId: ID của site

8. matomo_add_goal

Thêm goal mới.

Tham số:

siteId: ID của site
name: Tên goal
description: Mô tả
matchAttribute: Thuộc tính khớp
pattern: Mẫu khớp
patternType: Loại mẫu

9. matomo_get_visits_summary

Lấy tổng quan lượt truy cập.

Tham số:

siteId: ID của site
date: Ngày (YYYY-MM-DD)
period: Chu kỳ (day, week, month, year)

10. matomo_get_top_pages

Lấy top pages.

Tham số:

siteId: ID của site
date: Ngày (YYYY-MM-DD)
period: Chu kỳ (tùy chọn)
limit: Số lượng kết quả (tùy chọn)

11. matomo_get_system_info

Lấy thông tin hệ thống.

Ví dụ sử dụng

Kết nối đến Matomo:

{
  "name": "matomo_connect",
  "arguments": {
    "baseUrl": "https://analytics.example.com",
    "tokenAuth": "your-api-token"
  }
}

Lấy danh sách sites:

{
  "name": "matomo_get_sites",
  "arguments": {}
}

Thêm site mới:

{
  "name": "matomo_add_site",
  "arguments": {
    "name": "My Website",
    "urls": ["https://example.com", "https://www.example.com"],
    "timezone": "Asia/Ho_Chi_Minh"
  }
}

Lưu ý

Đảm bảo bạn có quyền truy cập API với token xác thực hợp lệ
Một số chức năng có thể yêu cầu quyền admin
Luôn kiểm tra kết nối trước khi sử dụng các tools khác

Đóng góp

Mọi đóng góp đều được chào đón! Vui lòng tạo issue hoặc pull request.

License

MIT License