用途
mcp-fathom-analytics 是一个非官方的 Model Context Protocol (MCP) 服务器，旨在让 AI 助手能够访问 Fathom Analytics 的数据。它通过 MCP 协议将 Fathom Analytics 的 API 能力暴露给支持 MCP 的 AI 客户端（如 Claude Desktop），使用户可以借助自然语言查询网站分析数据。
主要能力
该 MCP 服务器提供以下 Fathom Analytics 工具：
- get-account：获取 Fathom Analytics 账户的详细信息。
- list-sites：列出所有 Fathom Analytics 站点。
- list-events：列出特定站点的事件。
- get-aggregation：生成聚合分析报告，支持灵活的筛选和分组选项。
- get-current-visitors：获取当前站点访客的实时数据。
使用方式
该服务器通过 npm 发布为 npx 脚本。如果使用 Claude Desktop，可以通过 JSON 配置添加 MCP 服务器。更多关于其他 MCP 客户端的信息可参考 Model Context Protocol 示例客户端。
服务器内部使用 @mackenly/fathom-api SDK 与 Fathom Analytics API 端点交互，涉及的 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 天的每日页面浏览量统计
- 个别页面的表现
- 来自特定国家的流量
适用场景
适用于需要通过 AI 助手查询 Fathom Analytics 数据的用户，例如网站所有者、营销人员或数据分析师，希望以对话方式获取账户概览、站点列表、事件数据、聚合报告和实时访客信息。
限制
- 这是一个非官方项目，与 Fathom Analytics 无关联、未获其认可或支持。
- 该项目使用非官方 SDK @mackenly/fathom-api。
- 其他具体功能限制、收费情况或平台兼容性暂未提供。
许可与贡献
该项目采用 MIT 许可证，欢迎提交 Pull Request 进行贡献。
