Plausible Mcp Server

io.github.friendlygeorge由 GitHub 帳號 friendlygeorge 發布v1.0.0更新於 Oct 28, 2026

MCP server for Plausible Analytics — privacy-friendly web analytics. 12 tools for traffic, conver...

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

針對 Plausible Analytics 的 MCP 伺服器，讓助理查詢流量、轉換、來源與裝置分布等網站分析資料。

可以做什麼
  • 依指定指標、維度、篩選條件與日期範圍執行彈性的資料查詢
  • 取得即時訪客數，以及按日、週、月或小時間隔的時間序列資料
  • 依來源、頁面、國家、瀏覽器、作業系統、螢幕尺寸與 UTM 活動拆分流量
  • 檢視自訂事件、進入頁與離開頁，以及各目標的轉換統計
  • 列出並檢視帳戶中的網站資訊
適用情境
適合需要讓助理直接回答 Plausible 帳戶中網站流量與轉換問題（例如主要來源、訪客數、時間趨勢、目標轉換率），而不必開啟後台的情境。
執行需求
以本機 Node.js 程序執行（npm 套件 plausible-mcp-server，或以 npm 與 tsc 從原始碼建置）。需要 Plausible Analytics 帳戶（雲端或自架）與 API 金鑰，透過環境變數 PLAUSIBLE_API_KEY 提供；自架執行個體還需設定 PLAUSIBLE_API_BASE。需要能連線至 Plausible API 的網路。
安裝前請注意
需要 Plausible API 金鑰（PLAUSIBLE_API_KEY），可讀取你的分析帳戶資料，請勿寫入共用設定檔。所列工具僅讀取分析資料，但仍應確認金鑰的權限範圍。自架時 PLAUSIBLE_API_BASE 決定請求送往哪臺伺服器，只應指向可信任的執行個體。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Plausible Mcp Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Plausible Analytics MCP Server

MCP server for Plausible Analytics — privacy-friendly web analytics. Query traffic, conversions, sources, and device breakdowns from any MCP-compatible AI assistant.

Features

  • Flexible stats queries — metrics, dimensions, filters, date ranges
  • Real-time visitors — live visitor count
  • Traffic breakdowns — sources, countries, browsers, UTM campaigns
  • Time-series data — daily, weekly, monthly, hourly intervals
  • Custom events — event tracking and conversion rates
  • Entry/exit pages — where visitors land and leave
  • Device analytics — browser, OS, screen size breakdowns
  • Goal tracking — conversion stats for all configured goals
  • Site management — list and inspect sites

12 Tools

ToolDescription
query_statsFull flexible stats query (the main endpoint)
realtime_visitorsCurrent real-time visitor count
get_breakdownBreakdown by any dimension (source, page, country, etc.)
get_timeseriesMetrics over time with configurable intervals
list_sitesList all sites in your account
get_siteGet site details
get_custom_eventsCustom event breakdown
get_entry_pagesTop landing pages
get_exit_pagesTop exit pages
get_utm_statsUTM campaign/source/medium breakdowns
get_device_statsBrowser, OS, screen size breakdowns
get_goalsConversion stats for all goals

Setup

Prerequisites

  1. A Plausible Analytics account (cloud or self-hosted)
  2. An API key — generate one at Site Settings → API Keys in your Plausible dashboard

Configuration

Add to your MCP client config (e.g. Claude Desktop, Cursor):

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

For self-hosted Plausible, also set:

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

Build from source

bash
git clone https://github.com/friendlygeorge/plausible-mcp-server.gitcd plausible-mcp-servernpm installnpx tsc

Usage Examples

Once configured, ask your AI assistant:

  • "Show me the top traffic sources for my site this month"
  • "How many visitors did I get today?"
  • "What's the time-series of pageviews for the last 30 days?"
  • "Which pages have the highest bounce rate?"
  • "Show me UTM campaign performance"
  • "What are my top entry pages?"
  • "Show conversion rates for all goals"
  • "Break down visitors by country for the last week"

Environment Variables

VariableRequiredDefaultDescription
PLAUSIBLE_API_KEYYes—Your Plausible API key
PLAUSIBLE_API_BASENohttps://plausible.ioAPI base URL (change for self-hosted)

Supported Metrics

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

Supported Dimensions

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>

License

MIT

來源：README.md，提交 cd8ca3b

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。