remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows access to Fathom Analytics data including account information, sites management, events tracking, aggregated analytics reports, and real-time visitor tracking

MCP ファゾムアナリティクス

AIアシスタントを介してFathom Analyticsデータにアクセスするための非公式モデルコンテキストプロトコル（ MCP ）サーバーです。この実装では、@mackenly/fathom-api非公式SDKを使用してFathom Analytics APIと連携します。Fathom Analyticsと提携、承認、またはサポート関係にはありません。npxスクリプトとしてnpmに公開されています。

特徴

MCP サーバーは、次の Fathom Analytics ツールを提供します。

アカウント情報

get-account : Fathom Analytics アカウントの詳細を取得します

サイト管理

list-sites : Fathom Analytics のすべてのサイトを一覧表示します

イベント

list-events : 特定のサイトのイベントを一覧表示する

分析

get-aggregation : 柔軟なフィルタリングとグループ化のオプションを使用して集計分析レポートを生成します

訪問者追跡

get-current-visitors : 現在のサイト訪問者に関するリアルタイムデータを取得する

使用法

Claude Desktop をお使いの場合は、json 設定を使って MCP サーバーを追加できます（詳細はこちら）。以下に例を示します。

{
    "mcpServers": {
        "fathom-analytics": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-fathom-analytics"
            ],
            "env": {
                "FATHOM_API_KEY": "your_api_key_here"
            }
        }
    }
}

他のMCPクライアントの詳細については、こちらをご覧ください:モデルコンテキストプロトコルのサンプルクライアント

API構造

MCP サーバーは、@mackenly/fathom-api SDK を使用して Fathom Analytics API エンドポイントとインターフェースします。

アカウント API : https://api.usefathom.com/v1/account
サイト API : https://api.usefathom.com/v1/sites
イベント API : https://api.usefathom.com/v1/sites/SITE_ID/events
集計 API : https://api.usefathom.com/v1/aggregations
現在の訪問者 API : https://api.usefathom.com/v1/current_visitors

集計の例

集計ツールは非常に柔軟性が高いです。以下に使用例をいくつかご紹介します。

過去 30 日間の毎日のページビュー統計:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,visits",
  "date_grouping": "day",
  "date_from": "2023-08-01 00:00:00"
}

個々のページのパフォーマンス:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,avg_duration",
  "field_grouping": "pathname",
  "sort_by": "pageviews:desc",
  "limit": 10
}

特定の国からのトラフィック:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "visits",
  "field_grouping": "country_code",
  "sort_by": "visits:desc"
}

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

AI アシスタントが Fathom Analytics データにアクセスできるようにする非公式サーバー。ユーザーはアカウント情報、サイト統計、イベント、集計レポート、リアルタイムの訪問者追跡を取得できます。

Related Resources

Reddit Discussion about this server

MCP Fathom Analytics