Plausible Analytics MCP

io.github.surendranb由 GitHub 帳號 surendranb 發布v0.1.3更新於 Nov 3, 2026

Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.

已驗證STDIO僅桌面網頁搜尋與抓取資料與分析

服務詳細資訊

識別碼: io.github.surendranb/plausible-mcp
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Oct 29, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 surendranb。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.surendranb%2Fplausible-mcp.svg)](https://sourceweft.com/mcp/io.github.surendranb%2Fplausible-mcp?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

針對 Plausible Analytics 的唯讀 MCP 伺服器，讓助理取得網站流量彙總、細分資料、趨勢與即時訪客數。

可以做什麼: 取得訪客數、瀏覽量、跳出率與造訪時長等網站彙總指標
依頁面、來源、國家、瀏覽器、作業系統或裝置細分指標
取得可繪圖的歷史時間序列資料，以及目前的即時訪客數
測試 API 連線並驗證已設定的權杖
列出並讀取內建的分析方法與操作手冊，檢查套件更新
適用情境: 適合讓助理回答 Plausible 雲端或自架網站的流量問題、快速產生報告或趨勢摘要，或查看目前線上訪客，而不必開啟儀表板。
執行需求: 以 stdio 方式在本機執行，通常透過 uvx（Python）或 npx 橋接啟動。需在 PLAUSIBLE_API_KEY 提供 Plausible Stats/Sites API 權杖，或透過工具參數傳入。自架執行個體可選用 PLAUSIBLE_BASE_URL，預設連線 Plausible 雲端。需要能連上 Plausible 執行個體的網路。

安裝前請注意

此 API 權杖可存取你的分析資料，應放在環境變數而非共用設定中。README 提到預設開啟匿名遙測，可用 DO_NOT_TRACK=1 關閉。工具本身為唯讀，但網站 ID 與權杖會傳送到所設定的 Plausible 端點。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

plausible-mcp

[PyPI version] [npm version] [License: MIT]

Fast, privacy-first Plausible Analytics Model Context Protocol (MCP) server for AI coding agents and LLM harnesses. Works seamlessly with both Plausible Cloud and self-hosted Plausible installations.

Quick Start

Run with uvx (Python)

Run with npx (Node / npm bridge)

Environment Configuration

Variable	Description	Default
`PLAUSIBLE_API_KEY`	Your Plausible Stats/Sites API token	Required (or pass via tool `token` arg)
`PLAUSIBLE_BASE_URL`	Base URL for self-hosted Plausible	`https://plausible.io`
`DO_NOT_TRACK`	Set to `1` to disable anonymous telemetry	`0`

Getting an API Key

Log in to Plausible (Cloud or your self-hosted instance).
Go to Settings (user profile menu) -> API Keys.
Click + New Key, name it mcp-agent, and copy the token.
Export as PLAUSIBLE_API_KEY="your_token".

Available Tools

Tool	Description
`get_aggregate_stats(site_id, date_range="30d", metrics=None, token=None)`	High-level visitor, pageview, bounce rate, and session duration totals
`get_breakdown(site_id, property_name="event:page", date_range="30d", limit=20, token=None)`	Segment metrics by pages, traffic sources, countries, browsers, OS, devices
`get_realtime_visitors(site_id, token=None)`	Current count of active visitors on the site right now
`get_timeseries(site_id, date_range="30d", interval="date", token=None)`	Daily or monthly trendline data points for chart generation
`doctor(token=None)`	Test Plausible API connectivity and validate the configured API token
`skills_list()`	List dynamic analytics playbooks and methodology guides
`skill_read(name)`	Fetch full markdown playbook by name (e.g. `plausible-overview`, `analytics-recipes`)
`check_for_updates()`	Check PyPI for newer versions and view upgrade commands

Error Absorption Standard

Errors returned to agents are explicitly classified:

[INPUT_FIXABLE]: Parameter errors (e.g., misspelled site_id, unknown dimension). Fix arguments and retry.
[ENVIRONMENT_FIXABLE: STOP & ASK HUMAN]: Missing, expired, or unauthorized API key. Prompt user with guided setup steps.
[TRANSIENT]: Upstream rate limits (HTTP 429) or network hiccups. Wait briefly and retry.

MCP Client Setup

Claude Desktop (`claude_desktop_config.json`)

json

{  "mcpServers": {    "plausible": {      "command": "uvx",      "args": ["plausible-mcp"],      "env": {        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"      }    }  }}

{  "mcpServers": {    "plausible": {      "command": "uvx",      "args": ["plausible-mcp"],      "env": {        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"      }    }  }}

Or using the npm bridge:

json

{  "mcpServers": {    "plausible": {      "command": "npx",      "args": ["-y", "plausible-analytics-mcp"],      "env": {        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"      }    }  }}

{  "mcpServers": {    "plausible": {      "command": "npx",      "args": ["-y", "plausible-analytics-mcp"],      "env": {        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"      }    }  }}

License

MIT License. See LICENSE for details.

來源：README.md，提交 b20381a

工具

get_aggregate_stats

Get aggregate website performance totals: visitors, pageviews, bounce_rate, and visit_duration. Args: site_id: Domain name of the site in Plausible (e.g. 'surendranb.com', 'freeinference.dev'). date_range: Time period ('day', 'today', 'yesterday', '7d', '30d', 'month', '6mo', '12mo', or 'YYYY-MM-DD,YYYY-MM-DD'). Default '30d'. metrics: Optional list of metrics (e.g. ['visitors', 'pageviews', 'bounce_rate', 'visit_duration', 'visits']). Defaults to standard 4 metrics. token: Optional Plausible API token. If omitted, uses PLAUSIBLE_API_KEY environment variable.

輸入參數tokenmetricssite_id必填date_range

get_breakdown

Get metrics breakdown by dimension: pages, sources, countries, browsers, operating systems, or devices. Args: site_id: Domain name of the site in Plausible (e.g. 'surendranb.com'). property_name: Dimension to segment by. Accepts aliases: 'page', 'source', 'country', 'browser', 'os', 'device', 'entry_page', 'exit_page', 'city', 'region', or full Plausible names like 'event:page', 'visit:source'. date_range: Time period ('day', '7d', '30d', 'month', '6mo', '12mo', or 'YYYY-MM-DD,YYYY-MM-DD'). Default '30d'. limit: Maximum number of rows to return (default 20, max 100). token: Optional Plausible API token. If omitted, uses PLAUSIBLE_API_KEY environment variable.

輸入參數limittokensite_id必填date_rangeproperty_name

get_realtime_visitors

Get the current count of active real-time visitors on the website right now. Args: site_id: Domain name of the site in Plausible (e.g. 'surendranb.com'). token: Optional Plausible API token. If omitted, uses PLAUSIBLE_API_KEY environment variable.

輸入參數tokensite_id必填

get_timeseries

Get historical timeseries trendlines (visitors, pageviews) over time for plotting charts. Args: site_id: Domain name of the site in Plausible (e.g. 'surendranb.com'). date_range: Time period ('day', '7d', '30d', 'month', '6mo', '12mo', or 'YYYY-MM-DD,YYYY-MM-DD'). Default '30d'. interval: Aggregation bucket: 'date' (daily) or 'month' (monthly). Default 'date'. token: Optional Plausible API token. If omitted, uses PLAUSIBLE_API_KEY environment variable.

輸入參數tokensite_id必填intervaldate_range

doctor

Test connectivity to Plausible Cloud or self-hosted instance (PLAUSIBLE_BASE_URL) and validate API token. Args: token: Optional Plausible API token to test. If omitted, tests PLAUSIBLE_API_KEY from environment.

輸入參數token

skills_list

List available Plausible Analytics operational skills and playbooks.

無需輸入參數。

skill_read

Fetch guidance and analytical playbooks for Plausible Analytics by name. Args: name: Name of skill to read (e.g. 'plausible-overview', 'analytics-recipes'). Call skills_list() to view all.

輸入參數name必填

check_for_updates

Check PyPI for newer versions of plausible-mcp and get upgrade instructions.