Mixpanel MCP 服务器使用说明

项目简介

Mixpanel MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，它作为 Mixpanel 分析平台的接口，旨在通过标准化的方式向 LLM 客户端（如 Cursor 或 Claude Desktop）提供 Mixpanel 的事件数据查询和分析能力。用户可以通过自然语言指令，利用 LLM 客户端调用该 MCP 服务器提供的工具，从而便捷地访问和分析 Mixpanel 中的用户行为数据。

主要功能点

事件数据查询: 支持查询 Mixpanel 中各种类型的事件数据，包括总量、去重计数和平均值等。
用户行为分析: 提供用户行为分析工具，例如获取用户事件活动流、用户留存率、用户行为路径（漏斗分析）等。
报表数据获取: 可以查询 Mixpanel 中 Insights 报表和漏斗报表的数据。
灵活的数据查询: 支持自定义 JQL 查询，允许用户进行复杂的、个性化的数据分析。
多维度数据分析: 支持按事件属性进行数据分段和过滤，帮助用户从不同维度理解数据。

安装步骤

方法一：通过 Smithery 自动安装 (推荐 Claude Desktop 用户使用)

安装 Smithery CLI: 如果尚未安装，请先安装 Smithery CLI 工具。

npm install -g @smithery/cli

自动安装 Mixpanel MCP 服务器: 运行以下命令，即可为 Claude Desktop 自动安装 Mixpanel MCP 服务器。

npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claude

按照提示完成安装。

方法二：手动安装 (推荐 Cursor 用户和本地运行)

克隆仓库: 将 GitHub 仓库 'dragonkhoi/mixpanel-mcp' 克隆到本地。

git clone https://github.com/dragonkhoi/mixpanel-mcp.git
cd mixpanel-mcp

构建项目: 在项目根目录下运行以下命令构建项目。

npm install
npm run build

配置 Mixpanel 服务账号:
- 登录 Mixpanel，进入你的项目。
- 前往 "Organization Settings" (组织设置) 创建 Service Account (服务账号)，获取 Username (用户名) 和 Password (密码)。
- 在 "Project Settings" (项目设置) 中找到 Project ID (项目 ID)。
- 将这些信息记录下来，后续配置 MCP 服务器时需要用到。

服务器配置 (MCP 客户端配置)

以下是在 MCP 客户端 (例如 Cursor) 中配置 Mixpanel MCP 服务器的示例配置信息。你需要根据你选择的安装方式选择相应的配置。

配置 1：Smithery 自动安装 (Claude Desktop 或 Cursor)

如果你使用 Smithery 自动安装，可以参考以下配置添加到 MCP 客户端。以 Cursor 为例，在 'Settings -> Cursor Settings -> Features -> MCP Servers -> + Add' 中，选择 'Type: command'，并粘贴以下 JSON 配置，请务必替换以下配置中的 'YOUR_SERVICE_ACCT_USERNAME', 'YOUR_SERVICE_ACCT_PASSWORD', 和 'YOUR_MIXPANEL_PROJECT_ID' 为你实际的 Mixpanel 服务账号信息和项目 ID。

{
  "serverName": "Mixpanel Integration",
  "command": "npx",
  "args": [
    "-y",
    "@smithery/cli@latest",
    "run",
    "@dragonkhoi/mixpanel-mcp",
    "--config",
    "{\"username\":\"YOUR_SERVICE_ACCT_USERNAME\",\"password\":\"YOUR_SERVICE_ACCT_PASSWORD\",\"projectId\":\"YOUR_MIXPANEL_PROJECT_ID\"}"
  ]
}

'serverName': 自定义的服务名称，例如 "Mixpanel Integration"。
'command': 运行 MCP 服务器的命令，这里使用 'npx'。
'args': 命令参数，包括：
- '-y': 'npx' 参数，自动确认安装 Smithery CLI。
- '@smithery/cli@latest': Smithery CLI 工具，用于运行 MCP 服务器。
- 'run': Smithery CLI 的 'run' 命令，用于运行指定的 MCP 服务器。
- '@dragonkhoi/mixpanel-mcp': 要运行的 MCP 服务器的 Smithery 包名。
- '--config': 配置参数标志。
- '{"username":"YOUR_SERVICE_ACCT_USERNAME","password":"YOUR_SERVICE_ACCT_PASSWORD","projectId":"YOUR_MIXPANEL_PROJECT_ID"}': JSON 格式的配置字符串，包含 Mixpanel 服务账号的用户名、密码和项目 ID。 请替换 'YOUR_SERVICE_ACCT_USERNAME', 'YOUR_SERVICE_ACCT_PASSWORD', 和 'YOUR_MIXPANEL_PROJECT_ID' 为您实际的 Mixpanel 服务账号信息和项目 ID。

配置 2：本地克隆运行 (Cursor 或本地环境)

如果你选择本地克隆仓库并运行，可以使用以下配置。请务必将 '/ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js' 替换为你本地 'mixpanel-mcp/build/index.js' 文件的绝对路径, 并替换 'YOUR_SERVICE_ACCOUNT_USERNAME', 'YOUR_SERVICE_ACCOUNT_PASSWORD', 和 'YOUR_PROJECT_ID' 为你实际的 Mixpanel 服务账号信息和项目 ID。

{
  "serverName": "Mixpanel Integration (Local)",
  "command": "node",
  "args": [
    "/ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js",
    "YOUR_SERVICE_ACCOUNT_USERNAME",
    "YOUR_SERVICE_ACCOUNT_PASSWORD",
    "YOUR_PROJECT_ID"
  ]
}

'serverName': 自定义的服务名称，例如 "Mixpanel Integration (Local)"。
'command': 运行 MCP 服务器的命令，这里使用 'node'。
'args': 命令参数，包括：
- '/ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js': 请替换为 'mixpanel-mcp/build/index.js' 文件的绝对路径。
- 'YOUR_SERVICE_ACCOUNT_USERNAME': 请替换为你的 Mixpanel 服务账号用户名。
- 'YOUR_SERVICE_ACCOUNT_PASSWORD': 请替换为你的 Mixpanel 服务账号密码。
- 'YOUR_PROJECT_ID': 请替换为你的 Mixpanel 项目 ID。

基本使用方法

启动 MCP 客户端: 启动你配置的 MCP 客户端，例如 Cursor 或 Claude Desktop。
连接 MCP 服务器: MCP 客户端应该会自动连接到你配置的 Mixpanel MCP 服务器。
使用自然语言指令: 在 MCP 客户端中，你可以使用自然语言指令来调用 Mixpanel MCP 服务器提供的工具。例如：
- 在 Cursor 中，你可以直接在聊天框中提问： '"Get today's top events from Mixpanel"'
- 你可以更具体地指定参数，例如： '"What are the top 5 unique events today in Mixpanel project <你的项目ID>?"' (请将 '<你的项目ID>' 替换为你的实际项目 ID)
探索可用工具: 你可以使用 MCP 客户端的工具发现功能 (如果支持) 来查看 Mixpanel MCP 服务器提供的所有工具及其参数。或者参考代码 'src/index.ts' 文件中 'server.tool(...)' 的定义来了解所有可用的工具和参数。

通过以上步骤，你就可以利用 Mixpanel MCP 服务器，在 LLM 客户端中便捷地查询和分析 Mixpanel 数据了。

关键词