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 Fathom 分析

一个非官方的模型上下文协议 ( MCP ) 服务器，用于通过 AI 助手访问Fathom Analytics数据。此实现使用@mackenly/fathom-api非官方 SDK 与 Fathom Analytics API 进行交互。Fathom Analytics 与此无关，亦未获得其认可或支持。已作为 npx script 发布到 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"
}

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 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