用途:为 MCP 服务器提供产品分析,可追踪每次工具调用、agent 意图和失败,是 @posthog/ai 在 MCP 层面的同类产品;其差异点在于记录意图(如“在找流失人群”)而非仅记录调用次数。明确非目标:不取代 LLM 分析/可观测性,生成轨迹、提示词与响应、token 成本应归后者。
主要能力:TypeScript(@posthog/mcp)和 Python(posthog.mcp,含在 pip install posthog 内,fastmcp 为惰性导入的 peer 依赖)SDK 已发布,可供所有项目使用;数据落在共享 ClickHouse events 表,按 $mcp_tool_call 等事件聚合,常用维度为 $session_id。提供会话列表、工具质量、意图聚类的专用分析技能,以及 query-mcp-tool-stats、-daily-stats、-failures、-failure-occurrences、-descriptions、-neighbors、-sample-intents、-top-users、query-mcp-harness-breakdown 等类型化工具,优于手写 HogQL。意图按会话由 LLM 生成两句话摘要;意图聚类走嵌入加凝聚聚类并写入快照。
使用方式:用 SDK 包裹服务器开始埋点,查询优先走专用分析技能与类型化工具,仪表盘和工具质量查询由 /query/ 端点的类型化 query runner 提供,受 mcp_analytics RBAC 资源校验。
限制:状态为 beta;无独立数据表;失败须从 $mcp_is_error/$mcp_error_type/$mcp_error_status 读取,不能用 $exception;工具名必须经 EFFECTIVE_TOOL_SQL 的 coalesce 解析;进行中的时间桶需加虚线标记;harness 无存储列、仅查询时解析;无状态规范下未开启会话锚定则 $session_id 会碎片化;会话列表默认 7 天窗口并缓存 30 秒;聚类受快照簇数与查询行数上限约束;需区分归档原型 PostHog/mcp-analytics 与本产品。更多价格、平台等细节暂未提供。