项目简介

Hackle MCP Server 是一个实现了 Model Context Protocol (MCP) 的应用后端,它通过提供一系列工具,允许大型语言模型 (LLM) 客户端(如 Claude Desktop)访问 Hackle 平台中的数据,例如 A/B 测试结果、消息列表、数据分析报告、远程配置等。

主要功能点

该服务器提供以下类别的工具,让LLM能够查询Hackle数据:

  • A/B 测试管理: 查询实验列表和特定实验的详细信息。
  • 消息管理: 获取应用内消息和推送消息的列表及详情。
  • 用户指标: 查询活跃用户、留存和粘性等时间序列数据。
  • 数据报告与分析图表: 获取数据报告列表及详情,以及数据分析图表(如漏斗、留存等)的列表及详情。
  • 远程配置: 查询远程配置列表和特定配置的详细信息。

安装步骤

要使用Hackle MCP Server,您需要将其配置到您的MCP客户端应用(例如Claude Desktop)的配置文件中。

  1. 找到您的Claude Desktop配置文件 'claude_desktop_config.json':
    • Mac: '~/Library/Application Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%\Claude\claude_desktop_config.json'
    • Linux: '~/.config/Claude/claude_desktop_config.json'
  2. 打开该文件,并在顶层的 '"mcpServers"' 对象中添加一个名为 '"hackle-mcp"' 的条目。

服务器配置

在 'claude_desktop_config.json' 文件中为 '"hackle-mcp"' 配置启动信息。这包括服务器名称、启动命令和所需的API密钥。

  • '"hackle-mcp"': 这是您为该MCP服务器指定的内部名称。
  • '"command"': 设置为 '"npx"'。这是Node.js的包运行器,用于直接执行npm包提供的命令。
  • '"args"': 设置为 '["-y", "@hackle-io/hackle-mcp@latest"]'。这是传递给 'npx' 的参数,指示它下载并运行最新版本的 '@hackle-io/hackle-mcp' 包。
  • '"env"': 这是一个对象,用于设置启动服务器进程时所需的环境变量。
    • '"API_KEY"': 非常重要。设置您的Hackle API密钥。您需要通过Hackle团队获取此密钥。请确保妥善保管您的API密钥,不要将其泄露或提交到公共仓库。

配置完成后,保存文件并重启Claude Desktop客户端。

获取API密钥

要使用Hackle MCP Server,您必须拥有一个API密钥。请通过Hackle Slack社区联系Hackle团队以获取专门用于MCP服务器访问的API密钥。

基本使用方法

配置并重启客户端后,您的LLM客户端将能够识别并使用Hackle MCP Server提供的工具。您现在可以直接在与LLM的对话中提出关于Hackle数据的问题,例如:

  • "列出我最近的A/B实验。" (LLM可能会使用 'experiment-list' 工具)
  • "告诉我实验ID为123的详细结果。" (LLM可能会使用 'experiment-detail' 工具)
  • "过去一个月我的周活跃用户趋势如何?" (LLM可能会使用 'active-user-series' 工具,参数 'unit' 为 WEEK)

LLM将自行判断何时调用哪个工具,并利用工具返回的数据来回答您的问题或提供信息。

信息

分类

开发者工具