Mixpanel MCP Server

Mixpanel MCP 服务

一个用于将 Mixpanel 分析集成到 AI 工作流中的 模型上下文协议（MCP） 服务。此服务允许 Claude 等 AI 助手在 Mixpanel 中跟踪事件、页面浏览、用户注册并更新用户资料。

版本 2.0.1 说明： 工具名称现在包含 mixpanel_ 前缀，以避免与其他分析 MCP 服务发生命名空间冲突。

目录

• 功能
• 安装
• 快速开始
• 详细用法
  • 使用 Claude Desktop
  • 使用其他 MCP 客户端
• 工具参考
• 示例
• 故障排除
• 安全说明
• 参与贡献
• 许可证

功能

• 在 Mixpanel 中跟踪自定义事件
• 跟踪包含引荐来源信息的页面浏览
• 跟踪用户注册并创建用户资料
• 更新现有用户资料
• 轻松集成 Claude Desktop 和其他 MCP 客户端

安装

先决条件

• Node.js 16 或更高版本
• Mixpanel 项目令牌（在 Mixpanel 注册即可获取）

NPM 安装（推荐）

# Install globally
npm install -g mixpanel-mcp-server

# Or use directly with npx
npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

手动安装

# Clone the repository
git clone https://github.com/yourusername/mixpanel-mcp-server.git
cd mixpanel-mcp-server

# Install dependencies
npm install

# Run the server
node index.js --token YOUR_MIXPANEL_TOKEN

快速开始

要开始在 Claude Desktop 中使用 Mixpanel MCP 服务：

1. 确保你的计算机上已安装 Claude Desktop（从 claude.ai/download 下载）

2. 创建或编辑 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%AppData%\Claude\claude_desktop_config.json

3. 添加 Mixpanel MCP 服务配置：

{
  "mcpServers": {
    "mixpanel-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mixpanel-mcp-server",
        "--token",
        "YOUR_MIXPANEL_TOKEN"
      ]
    }
  }
}

4. 重启 Claude Desktop，开始跟踪分析数据！

详细用法

使用 Claude Desktop

按照“快速开始”部分所示设置配置文件后，你可以直接在与 Claude 的对话中使用 Mixpanel 分析功能。

可以使用的提示词示例：

• “在 Mixpanel 中为用户 user123 跟踪名为 document_generated 的自定义事件”
• “在 Mixpanel 中跟踪主页的页面浏览”
• “在 Mixpanel 中为 John Doe 创建新的用户资料，邮箱为 [email protected]”
• “在 Mixpanel 中更新用户 user123 的资料信息”

Claude 会根据你的请求使用相应的 Mixpanel MCP 工具。

使用其他 MCP 客户端

此服务使用标准的模型上下文协议，可与任何 MCP 客户端集成：

1. 启动服务：

   npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN
   

2. 使用 stdio 传输将 MCP 客户端连接到服务

3. 客户端可以发现并使用可用工具（mixpanel_track_event、mixpanel_track_pageview、mixpanel_track_signup、mixpanel_set_user_profile）

工具参考

Mixpanel MCP 服务提供以下工具：

mixpanel_track_event

在 Mixpanel 中跟踪自定义事件。

参数：

• event_name（字符串，必需）：要跟踪的事件名称
• distinct_id（字符串，可选）：用户标识符。默认为“anonymous”
• properties（对象，可选）：与事件一同跟踪的其他属性

示例：

{
  "event_name": "button_clicked",
  "distinct_id": "user123",
  "properties": {
    "button_id": "submit_form",
    "page": "checkout"
  }
}

mixpanel_track_pageview

在 Mixpanel 中跟踪页面浏览事件。

参数：

• page_name（字符串，必需）：所浏览页面的名称
• distinct_id（字符串，可选）：用户标识符。默认为“anonymous”
• referrer（字符串，可选）：引荐页面

示例：

{
  "page_name": "homepage",
  "distinct_id": "user123",
  "referrer": "google.com"
}

mixpanel_track_signup

在 Mixpanel 中跟踪注册事件并创建用户资料。

参数：

• user_name（字符串，必需）：用户全名
• email（字符串，必需）：用户邮箱地址
• plan（字符串，可选）：注册方案。默认为“free”

示例：

{
  "user_name": "John Doe",
  "email": "[email protected]",
  "plan": "premium"
}

mixpanel_set_user_profile

更新 Mixpanel 中用户的个人资料属性。

参数：

• distinct_id（string，必填）：用户标识符
• properties（object，必填）：要设置的个人资料属性

示例：

{
  "distinct_id": "user123",
  "properties": {
    "$name": "John Doe",
    "$email": "[email protected]",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

示例

以下是使用 Claude 的 Mixpanel MCP 服务的一些实用示例：

跟踪按钮点击

You: Can you track an event in Mixpanel when a user clicks the submit button?

Claude: I'll track that event for you. Let me use the Mixpanel analytics tool.

[Claude uses the mixpanel_track_event tool with appropriate parameters]

Claude: I've successfully tracked the 'button_clicked' event in Mixpanel with the properties you specified.

创建用户个人资料

You: Create a new user profile in Mixpanel for Sarah Johnson who signed up with [email protected] on the premium plan.

Claude: I'll create that user profile in Mixpanel.

[Claude uses the mixpanel_track_signup tool with appropriate parameters]

Claude: I've successfully tracked the signup for Sarah Johnson and created a profile in Mixpanel with the premium plan.

故障排除

常见问题

1. 服务无法启动：

   • 确保已提供有效的 Mixpanel 令牌
   • 检查是否已安装 Node.js，且版本为 16 或更高

2. Claude Desktop 未显示 Mixpanel 工具：

   • 验证 claude_desktop_config.json 文件的语法
   • 确保编辑配置后已重启 Claude Desktop
   • 检查服务路径是否正确

3. 事件未显示在 Mixpanel 中：

   • 验证 Mixpanel 令牌是否正确
   • 检查 Mixpanel 项目设置，确保正在接收数据
   • 事件可能需要几分钟才会显示在 Mixpanel 界面中

调试模式

如需以调试模式运行服务并输出更详细的日志：

npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN --debug

安全注意事项

• Mixpanel 令牌存储在 Claude Desktop 配置文件中。请确保此文件具有适当的权限
• 在生产环境中，考虑使用环境变量存储敏感令牌
• 此服务未实现速率限制；考虑在生产环境中添加额外的安全措施
• 事件会直接发送到 Mixpanel 的 API；请查看 Mixpanel 的隐私政策，了解其数据处理方式

贡献

欢迎贡献！欢迎提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开 Pull Request

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。