Engageable Analytics

tech.engageable由 engageable.tech 发布v0.2.0更新于 Oct 24, 2026

Unified analytics MCP server for GA4, Mixpanel, and PostHog.

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手连接 GA4、Mixpanel 和 PostHog，并对这些数据做趋势、漏斗、留存和异常分析。

可以做什么
  • 列出并配置已连接的 analytics 数据源
  • 做时间序列趋势分析，含变点和异常检测
  • 比较细分群体与 A/B 测试，给出统计显著性
  • 发现突增、骤降和异常模式
  • 分析留存队列、转化漏斗和用户群组
  • 用自然语言提问，由 LLM 路由到其他分析工具作答
适用场景
适合已把产品或网站分析数据放在 GA4、Mixpanel 或 PostHog 中，希望助手直接查询和解读这些数据、而不必为每个平台单独做集成的场景。
运行要求
以 Python 包本地运行（pip install engageable），通过 stdio 通信，也可用 Docker 以 SSE 方式运行。需按数据源提供凭据：POSTHOG_API_KEY 与 POSTHOG_PROJECT_ID，或 MIXPANEL_SERVICE_ACCOUNT_USERNAME、MIXPANEL_SERVICE_ACCOUNT_SECRET 与 MIXPANEL_PROJECT_ID，或 GA4_CREDENTIALS_JSON 与 GA4_PROPERTY_ID。ask 工具还需 ANTHROPIC_API_KEY。凭据可设为环境变量，或保存到本地凭据文件。
安装前请注意
需要多个密钥：ANTHROPIC_API_KEY、POSTHOG_API_KEY、MIXPANEL_SERVICE_ACCOUNT_SECRET 以及 GA4 服务账号凭据。configure_source 工具会把凭据写入用户主目录下的文件。分析数据会发送给各分析平台，ask 工具还会发送给 Anthropic。工具本身以分析为主，但会把生产分析数据暴露给助手。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Engageable Analytics，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Engageable

The open source analytics engine for AI agents.

One MCP server that connects to GA4, Mixpanel, PostHog, and more. 9 tools that replace per-platform integrations. Bring your own Anthropic key.

Quickstart

bash
pip install engageableexport ANTHROPIC_API_KEY=sk-ant-...export POSTHOG_API_KEY=phc_...export POSTHOG_PROJECT_ID=12345engageable-mcp

That's it. The MCP server is running on stdio. Connect it to Claude Desktop, Cursor, or any MCP client.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "engageable": {      "command": "engageable-mcp",      "args": []    }  }}

Restart Claude Desktop. You'll see 9 analytics tools available.

Docker

bash
ANTHROPIC_API_KEY=sk-ant-... docker compose -f docker-compose.mcp.yml up

Connects via SSE at http://localhost:8080/sse.

Tools

ToolWhat it does
get_sourcesList connected data sources
configure_sourceConnect a new data source (saves to ~/.engageable/credentials.json)
analyze_trendsTime-series analysis with trend detection, change points, anomalies
compare_segmentsA/B tests, before/after, segment breakdown with statistical significance
detect_anomaliesFind spikes, drops, and unusual patterns
analyze_retentionCohort retention curves (D1/D7/D30)
analyze_funnelMulti-step conversion funnel with drop-off rates
analyze_cohortDefine and compare user cohorts
askNatural language analytics questions (routes to other tools via LLM)

Supported Data Sources

SourceAuthWhat you need
PostHogAPI keyPOSTHOG_API_KEY + POSTHOG_PROJECT_ID
MixpanelService accountMIXPANEL_SERVICE_ACCOUNT_USERNAME + MIXPANEL_SERVICE_ACCOUNT_SECRET + MIXPANEL_PROJECT_ID
Google Analytics 4Service accountGA4_CREDENTIALS_JSON (path or inline) + GA4_PROPERTY_ID

Set these as environment variables, or use the configure_source tool to save them interactively to ~/.engageable/credentials.json. See credentials.example.json for the file format.

How It Works

Engageable exposes analytics tools via the Model Context Protocol (MCP). Any MCP-compatible client (Claude, Cursor, VS Code, custom agents) can discover and call these tools.

Each tool is a self-contained pipeline: parse the request, fetch data from the right connector, run analysis, return results. The ask tool adds an LLM routing layer for natural language questions.

Responses use CSV for tabular data (50% fewer tokens than JSON) with a 1000-cell budget to keep context windows manageable.

Architecture

MCP Client (Claude, Cursor, etc.)    │    ▼┌─────────────────────────────────────┐│  MCP Server (stdio or SSE)          ││  - Dynamic tool registration        ││  - Credential injection             ││  - CSV response formatting          │├─────────────────────────────────────┤│  Composite Skills (agent-facing)    ││  analyze_trends, compare_segments,  ││  detect_anomalies, analyze_funnel,  ││  analyze_retention, analyze_cohort, ││  ask, get_sources, configure_source │├─────────────────────────────────────┤│  Connector Skills (internal)        │  Analysis Skills (internal)│  ga4_query, posthog_query,          │  trend_detection, significance,│  mixpanel_query, + metadata/probe   │  cohort_retention, forecasting,│                                     │  bayesian_ab, correlation, ...└─────────────────────────────────────┘

License

MIT

来源：README.md，提交 a2f0652

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。