plausible-mcp-server

Plausible Analytics MCP 服务

适用于 Plausible Analytics 的 MCP 服务——注重隐私的网站分析工具。通过任何兼容 MCP 的 AI 助手查询流量、转化、来源和设备细分数据。

功能

• 灵活的统计查询 — 指标、维度、筛选条件、日期范围
• 实时访客 — 实时访客数
• 流量细分 — 来源、国家/地区、浏览器、UTM 营销活动
• 时间序列数据 — 按日、周、月、小时划分的时间间隔
• 自定义事件 — 事件跟踪和转化率
• 入口/退出页面 — 访客的进入和离开页面
• 设备分析 — 按浏览器、操作系统、屏幕尺寸细分
• 目标跟踪 — 所有已配置目标的转化统计
• 网站管理 — 列出并查看网站信息

12 个工具

工具	描述
query_stats	灵活的完整统计查询（主要端点）
realtime_visitors	当前实时访客数
get_breakdown	按任意维度细分（来源、页面、国家/地区等）
get_timeseries	按可配置的时间间隔查看指标变化
list_sites	列出账户中的所有网站
get_site	获取网站详情
get_custom_events	自定义事件细分
get_entry_pages	热门入口页面
get_exit_pages	热门退出页面
get_utm_stats	UTM 营销活动/来源/媒介细分
get_device_stats	按浏览器、操作系统、屏幕尺寸细分
get_goals	所有目标的转化统计

设置

前置条件

1. 一个 Plausible Analytics 账户（云端或可自托管）
2. 一个 API 密钥——在 Plausible 控制面板的 Site Settings → API Keys 中生成

配置

将以下内容添加到 MCP 客户端配置中（例如 Claude Desktop、Cursor）：

{
  "mcpServers": {
    "plausible": {
      "command": "node",
      "args": ["/path/to/plausible-mcp-server/dist/index.js"],
      "env": {
        "PLAUSIBLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

对于自托管的 Plausible，还需设置：

"env": {
  "PLAUSIBLE_API_KEY": "your-api-key",
  "PLAUSIBLE_API_BASE": "https://your-plausible-instance.com"
}

从源代码构建

git clone https://github.com/friendlygeorge/plausible-mcp-server.git
cd plausible-mcp-server
npm install
npx tsc

使用示例

配置完成后，可以向 AI 助手提问：

• “显示我网站本月的主要流量来源”
• “我今天有多少访客？”
• “过去 30 天的页面浏览量时间序列是什么？”
• “哪些页面的跳出率最高？”
• “显示 UTM 营销活动的效果”
• “我的热门入口页面有哪些？”
• “显示所有目标的转化率”
• “按国家/地区细分上周的访客”

环境变量

变量	必需	默认值	描述
PLAUSIBLE_API_KEY	是	—	Plausible API 密钥
PLAUSIBLE_API_BASE	否	https://plausible.io	API 基础 URL（自托管时更改）

支持的指标

visitors、visits、pageviews、views_per_visit、visit_duration、events、bounce_rate、scroll_depth、conversion_rate

支持的维度

visit:source、visit:referrer、visit:utm_source、visit:utm_medium、visit:utm_campaign、visit:utm_content、visit:utm_term、visit:country_name、visit:city_name、visit:screen、visit:browser、visit:browser_version、visit:os、visit:os_version、visit:entry_page、visit:exit_page、event:page、event:name、event:goal、event:props:<key>

许可证

MIT