A/B测试数据分析服务器

Hackle MCP Server是一个模型上下文协议服务器,为Hackle API提供A/B测试数据查询工具和资源。

  • by hackle-io
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 hackle-io/hackle-mcp

使用说明

Hackle MCP服务器

[!警告]

⚠️ 此本地npm包已弃用——请使用远程MCP服务器

Hackle MCP服务器现在可以作为 远程服务器,这个本地npm包是 已弃用远程服务器不需要npm或Node.js设置,自动更新,在浏览器中工作,是所有新工具(如消息统计和Kakao/短信查询)的所在地。

此软件包将不再接收更新或新工具。 现有安装目前仍能正常工作,但请迁移到远程服务器。

👉 迁移指南:https://docs.hackle.io/external-link/model-context-protocol/migration

如何连接到远程服务器

  1. 添加自定义连接器 在claude.ai(网络)或克劳德桌面通过 定制→ 连接器→ + 添加自定义连接器,使用远程MCP服务器URL:

    https://mcp.hackle.io/mcp
    
  2. 输入您的 现有Hackle API密钥 在身份验证屏幕中-您的API密钥保持不变。

  3. 连接后,您可以选择从您的 claude_desktop_config.json.

用于Hackle API的模型上下文协议服务器,提供用于查询A/B测试数据的工具和资源。

特征

工具

实验列表工具

  • 名称: experiment-list
  • 描述:使用搜索功能获取a/B测试实验的分页列表。
  • 参数:
    • pageNumber:页码(默认值:1)
    • pageSize:每页项目数(默认值:100)
    • searchKeyword:搜索关键字(可选)

实验细节工具

  • 名称: experiment-detail
  • 描述:检索特定a/B测试实验的详细信息。
  • 参数:
    • experimentId:实验ID

应用内消息列表工具

  • 名称: in-app-message-list
  • 描述:通过搜索功能获取应用内消息的分页列表。
  • 参数:
    • pageNumber:页码(默认值:1)
    • pageSize:每页项目数(默认值:100)
    • searchKeyword:搜索关键字(可选)

应用内消息详细信息工具

  • 名称: in-app-message-detail
  • 描述:检索特定应用内消息的详细信息。
  • 参数:
    • inAppMessageId:应用内消息ID

推送消息列表工具

  • 名称: push-message-list
  • 描述:通过搜索功能获取推送消息的分页列表。
  • 参数:
    • pageNumber:页码(默认值:1)
    • pageSize:每页项目数(默认值:100)
    • searchKeyword:搜索关键字(可选)

推送消息详细信息工具

  • 名称: push-message-detail
  • 描述:检索特定推送消息的详细信息。
  • 参数:
    • pushMessageId:推送消息ID

活动用户系列工具

  • 名称: active-user-series
  • 描述:检索活动用户的时间序列数据。提供每日、每周和每月单位。
  • 参数:
    • unit:时间单位(日、周、月)(默认值:日)
    • date:日期(可选)

保留系列工具

  • 名称: retention-series
  • 描述:检索用户保留时间序列数据。提供每日、每周和每月单位。
  • 参数:
    • unit:时间单位(日、周、月)(默认值:日)
    • date:日期(可选)

粘性系列工具

  • 名称: stickiness-series
  • 描述:检索用户粘性(回访频率)的时间序列数据。有每周和每月两种单位。
  • 参数:
    • unit:时间单位(周、月)(默认值:周)
    • date:日期(可选)

数据报告列表工具

  • 名称: data-report-list
  • 描述:检索所有数据报告元数据。

数据报告详细信息工具

  • 名称: data-report-detail
  • 描述:检索单个数据报告的详细信息。它将在数据报告中提供分析图表id和类型。建议使用分析图表详细信息工具来获取每个图表的更多信息。
  • 参数:
    • dataReportId:数据报告的id。这可以在数据报告列表工具的响应中找到。

分析图表列表工具

  • 名称: analytics-chart-list
  • 描述:检索数据分析图表的元数据列表。
  • 参数:
    • pageNumber:页码(默认值:1)(可选)
    • pageSize:每页项目数(默认值:100)(可选)
    • searchKeyword:搜索关键字(可选)(可选)
    • chartType:Hackle提供的图表类型:FUNNEL、DATA_INSIGHT、RETENTION和USER_PATH。(可选)

分析图表详细信息工具

  • 名称: analytics-chart-detail
  • 描述:检索数据分析图表的详细信息。您可以使用此工具的结果来可视化图表。
  • 参数:
    • chartId:分析图表的id。可以在数据报告详细信息工具或分析图表列表工具的响应中找到。
    • chartType:分析图表的类型(FUNNEL、DATA_INSIGHT、RETENTION、USER_PATH)。它可以在数据报告详细信息工具或分析图表列表工具的响应中找到。

远程配置列表工具

  • 名称: remote-config-list
  • 描述:检索远程配置列表。
  • 参数:
    • pageNumber:页码(默认值:1)
    • pageSize:每页项目数(默认值:100)
    • searchKeyword:搜索关键字(可选)
    • status:远程配置的状态:ACTIVE、ARCHIVED(默认值:“ACTIVE”)

远程配置详细信息工具

  • 名称: remote-config-detail
  • 描述:检索远程配置的详细信息。
  • 参数:
    • remoteConfigId:远程配置的id。您可以使用远程配置列表工具获取此信息。

远程配置创建工具

  • 名称: remote-config-create
  • 描述:创建空的远程配置。如果存在与要创建的RC关联的RC,建议先更新现有的RC,因为RC的总数是有限的。
  • 参数:
    • body:请求正文。
      • key:远程配置的名称。
      • description:远程配置的描述。
      • dataType:远程配置值的类型:STRING、JSON、NUMBER、BOOLEAN。
      • userIdentifierCriteria:用于定位的用户标识符标准。您可以使用Hackle提供的标准($deviceId、$userId)或您在Hackle仪表板网站上创建的标准。(默认值:“$deviceId”)

远程配置内容更新工具

  • 名称: remote-config-update
  • 描述:更新远程配置的内容。
  • 参数:
    • remoteConfigId:远程配置的id。
    • body:请求正文。
      • dataType:远程配置值的类型:STRING、JSON、NUMBER、BOOLEAN。如果dataType和远程配置值不匹配,则不会接受该请求。
      • remoteConfigDefaultValue:远程配置的默认值。此值的类型应与dataType字段匹配。
      • conditionalValues:具有用户组目标的条件远程配置值数组。
        • ruleName:目标条件规则的名称。
        • remoteConfigValue:远程配置的值。此值的类型应与dataType字段匹配。
        • target
          • conditions:目标规则。满足此数组中所有条件的用户将看到此规则的远程配置值。
            • key
              • type:条件类型:HACKLE_PROPERTY、USER_PROPERTY、AB_TEST、FEATURE_FLAG、COHORT、SEGMENT。
              • name:如果类型为HACKLE_Property或USER_Property,则为属性的名称。如果类型为AB_TEST,则输入实验键。如果类型为Feature_flag,则使用功能标志键。如果类型为COHORT或SEGMENT,则可以放置任何非空字符串。
            • match
              • operator:将用于匹配条件的键和值的运算符。
              • valueType:目标条件值的类型:数字、字符串、BOOLEAN、版本。
              • values:目标条件键的值。以下是一些特殊情况:如果您使用SEGMENT,这些值将被视为名称。如果类型为AB_TEST,则只允许使用字符串“A”和“B”。如果类型为FEATURE_FLAG,则只接受布尔值。如果类型是cohort,你应该输入队列的id。

远程配置用户标识符标准更新工具

  • 名称: remote-config-update-user-identifier-criteria
  • 描述:更新远程配置的用户标识符标准。此更改将应用于生产和开发环境。
  • 参数:
    • remoteConfigId:远程配置的id。
    • body:请求正文。
      • userIdentifierCriteria:用于定位的用户标识符标准。您可以使用Hackle提供的标准($deviceId、$userId)或您在Hackle仪表板网站上创建的标准。(默认值:“$deviceId”)

远程配置描述更新工具

  • 名称: remote-config-update-description
  • 描述:更新远程配置的描述。这一变化将应用于生产和开发环境。
  • 参数:
    • remoteConfigId:远程配置的id。
    • body:请求正文。
      • description:远程配置的描述。

安装

将此条目添加到claude_desktop_config.json中:

  • 在Mac上:~/库/应用程序支持/Claude/Claude_desktop_config json
  • 在Windows上:%APPDATA%\Claude\Claude_desktop_config.json
  • 在Linux上:~/.config/Claude/Claude_desktop_config json
{
  "mcpServers": {
    "hackle-mcp": {
      "command": "npx",
      "args": ["-y", "@hackle-io/hackle-mcp@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

如果正在运行,请重新启动Claude

获取API密钥

要使用Hackle MCP服务器,您需要一个API密钥。获取API密钥:

  1. 直接通过以下方式联系Hackle团队 Hackle Slack社区
  2. 请求API密钥以访问MCP服务器
  3. Hackle团队将为您提供一个独特的API密钥

重要:永远不要共享API密钥或将其提交到公共存储库。将API密钥视为敏感凭据。

许可证

麻省理工学院