plausible-mcp-server

Plausible Analytics MCP サーバー

P lausible Analytics 用の MCP サーバーです。プライバシーに配慮したウェブ分析を提供します。MCP 互換の AI アシスタントから、トラフィック、コンバージョン、流入元、デバイス別の内訳をクエリできます。

機能

• 柔軟な統計クエリ — 指標、ディメンション、フィルター、日付範囲
• リアルタイムの訪問者数 — 現在の訪問者数
• トラフィックの内訳 — 流入元、国、ブラウザー、UTM キャンペーン
• 時系列データ — 日別、週別、月別、時間別の間隔
• カスタムイベント — イベントのトラッキングとコンバージョン率
• 入口／離脱ページ — 訪問者が最初に訪れるページと離脱するページ
• デバイス分析 — ブラウザー、OS、画面サイズ別の内訳
• ゴールのトラッキング — 設定済みのすべてのゴールのコンバージョン統計
• サイト管理 — サイトの一覧表示と詳細の確認

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	ブラウザー、OS、画面サイズ別の内訳
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 キャンペーンのパフォーマンスを表示して」
• 「入口ページの上位を教えて」
• 「すべてのゴールのコンバージョン率を表示して」
• 「過去 1 週間の訪問者を国別に分類して」

環境変数

変数	必須	デフォルト	説明
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