mixpanel-mcp

你是否曾经在开产品会议时，突然被问到：“我们上个月的新用户留存率是多少？”或者“最近一周最常用的事件是哪个？”然后你不得不打开 Mixpanel，点来点去地筛选日期、选择事件、生成图表，再将数字抄到会议记录里。

如果能让 AI 助手直接在对话中回答这些问题，甚至帮你分析数据背后的趋势，那效率将大大提升。mixpanel-mcp 正是为此而生的工具。它是一个基于模型上下文协议的服务器，专门连接 Mixpanel 的 API，让你可以通过自然语言对话的方式，直接查询和分析你的产品事件数据。

项目基本信息

一、项目介绍

mixpanel-mcp 是一个轻量级的 MCP 服务器，它将 Mixpanel 的数据查询能力包装成 AI 可以调用的工具。Mixpanel 是一个领先的产品分析平台，用于追踪用户行为、分析留存率和转化漏斗。而这个服务器让你可以通过 MCP 客户端（如 Claude Desktop 或 Cursor）直接用自然语言提问，AI 会调用相应的接口，并返回结构化的数据。

目前，该项目已经支持查询事件数据、留存率和漏斗分析。开发者计划逐步增加对更多 Mixpanel API 的覆盖。通过这个服务器，非技术人员也能轻松获取产品数据洞察，而技术人员则可以将数据查询集成到自己的 AI 工作流中。

二、核心优势

用自然语言提问，而不是写 API 请求
你不再需要记住 Mixpanel API 的复杂参数和请求格式，也不需要编写代码。只需要像跟同事说话一样提问：“最近一周最常用的前五个事件是什么？”AI 会帮你处理好一切。

支持关键的分析类型
服务器已经实现了对事件查询、留存率和漏斗分析的支持。这些都是产品经理和增长团队最常用的分析场景。

简单安装，快速集成
项目支持通过 Smithery 一键安装到 Claude Desktop 或 Cursor，也支持手动克隆和构建。你只需要准备 Mixpanel 服务账号的用户名、密码和项目 ID 即可。

开源且可扩展
项目采用 MIT 许可证，代码完全开放。如果你需要特定的分析功能，可以直接修改源代码或提交 PR。

三、适用场景

产品经理的日常数据助手
晨会时可以直接问：“我们上周的日活跃用户数是多少？”或者“版本 2.0 发布后的七天留存率相比之前有提升吗？”

增长团队的效果分析
当你在讨论某个营销活动时，可以问：“来自 Facebook 渠道的用户，在注册后的付费转化率是多少？”AI 可以从 Mixpanel 中提取数据并回答。

开发过程中的实时验证
在开发新功能时，可以问：“刚刚部署的 new_checkout 事件开始有数据了吗？每小时大约多少条？”

数据民主化
让非技术团队成员（如市场、运营）也能自主查询数据，减少对数据分析师或开发者的依赖。

四、安装教程

安装 mixpanel-mcp 有以下几种方式。在开始前，请确保你已经拥有 Mixpanel 服务账号（在 Organization Settings 中创建）以及项目 ID。

准备工作

在 Mixpanel 中创建服务账号，记下：

• Username（服务账号用户名）
• Password（服务账号密码）
• Project ID（可以在 Project Settings 中找到）

方法一：通过 Smithery 安装到 Claude Desktop

关闭 Claude Desktop，在终端中运行：

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

根据提示，输入你的 Mixpanel 用户名、密码和项目 ID。安装完成后，重新启动 Claude Desktop。

方法二：通过 Smithery 安装到 Cursor

打开 Cursor，进入 Settings → Cursor Settings → Features → MCP Servers，点击 “+ Add” 按钮。选择 Type 为 “command”，然后粘贴以下命令，并替换对应的值。

npx -y @smithery/cli@latest run @dragonkhoi/mixpanel-mcp --config "{\"username\":\"你的服务账号用户名\",\"password\":\"你的服务账号密码\",\"projectId\":\"你的项目ID\"}"

方法三：手动克隆与构建

第一步：克隆仓库

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

第二步：安装依赖并构建

npm install
npm run build

第三步：配置 MCP 客户端

对于 Claude Desktop，打开配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %AppData%\Claude\claude_desktop_config.json），添加以下内容，注意将路径替换为你的实际路径，并填入你的 Mixpanel 凭证。

{
  "mcpServers": {
    "mixpanel": {
      "command": "node",
      "args": ["/你的完整路径/mixpanel-mcp/build/index.js", "你的用户名", "你的密码", "你的项目ID"]
    }
  }
}

对于 Cursor，类似地，在 MCP Servers 设置中添加一个 command 类型的服务器，command 为 node，args 为 ["/你的完整路径/mixpanel-mcp/build/index.js", "用户名", "密码", "项目ID"]。

五、使用示例

假设你已经配置好了服务器，以下是一些可以在 AI 客户端中尝试的对话。

示例1：查询事件概览

用户输入：帮我看看最近一周，Mixpanel 中数据最多的前五个事件是什么？

AI 会调用相应的工具，返回类似：

1. Page Viewed – 120,000 次
2. Button Clicked – 45,000 次
3. Sign Up – 1,200 次
4. Purchase – 300 次
5. Share – 150 次

示例2：查询留存率

用户输入：对于 2月1日 这个 cohort 的用户，他们的每周留存率是多少？

AI 会返回类似：“2月1日注册的用户，第 1 周留存率是 45%，第 2 周是 32%，第 3 周是 28%。”

示例3：查询漏斗转化

用户输入：从“开始注册”到“完成注册”，再到“首次购买”，这个漏斗在最近 30 天的整体转化率是多少？

AI 会返回每一步的转化率，例如：“开始注册 10,000 人，完成注册 8,000 人（80%），首次购买 2,000 人（25%）。”

示例4：对比不同版本

用户输入：对比 iOS 和 Android 用户的“充值”事件次数，过去一个月。

AI 会分别查询两个平台的数据，然后回答：“iOS 用户触发了 5,000 次充值，Android 用户触发了 3,200 次。”

六、常见问题

问题1：为什么我配置后，AI 无法查询到任何数据？

解决方案：请按顺序排查：

1. 确认你的 Mixpanel 服务账号凭证是否正确（用户名、密码、项目 ID）。
2. 确认该服务账号有权限访问你所查询的项目。
3. 检查你的项目中是否有数据（例如，过去几天是否真的有事件被发送）。
4. 在终端中手动运行你配置的命令，看是否有报错输出。

问题2：查询很慢或者超时。

解决方案：Mixpanel API 在处理大范围时间或大量事件时可能会慢。尝试缩小查询的时间范围，或者减少请求的数据量。如果是批量查询，建议分批次进行。

问题3：这个服务器支持哪些 Mixpanel API 功能？

解决方案：目前主要支持事件数据查询、留存率和漏斗分析。作者计划逐步增加更多功能。如果你有急需的功能，可以在 GitHub 仓库中提 issue 或贡献 PR。

问题4：我可以在生产环境中使用这个服务器吗？

解决方案：该项目还在积极开发中，功能集可能不完整。但对于简单的数据查询需求，它可以有效工作。建议在自己的账号中先测试，确保数据和查询结果满足要求。由于配置中需要明文保存密码，请确保你的电脑环境是安全的。

问题5：错误提示 “Invalid service account credentials” 怎么办？

解决方案：请仔细检查你的用户名和密码。注意：Mixpanel 服务账号密码不是你的登录密码，而是在创建服务账号时生成的特定密码。如果忘记，可以重新生成一个新的服务账号。

七、总结

mixpanel-mcp 是一个非常实用的 MCP 服务器，它精准地解决了“通过对话查询产品数据”这一需求。对于经常需要查看 Mixpanel 数据的团队来说，这个工具可以显著减少切换上下文和手动操作的时间。

该项目目前虽然功能不是最全面的，但它展示了一个清晰的模式：任何拥有丰富数据的 API，都可以被包装成 MCP 工具，让 AI 成为数据的“对话接口”。MIT 许可证和活跃的维护状态也意味着你可以放心使用，甚至参与贡献。

如果你正在寻找一种更智能、更自然的方式来与你的产品数据交互，mixpanel-mcp 绝对值得一试。随着作者逐步增加 API 覆盖，这个工具的价值会越来越大。