mixpanel-mcp-server

🚀 混合协议（MCP）分析工具使用指南

本工具集成了Mixpanel分析工具，支持事件跟踪、用户注册和配置文件管理，还具备详细日志记录功能，能帮助你更好地进行数据分析。

🚀 快速开始

在终端中运行以下命令启动工具：

npx mixpanel-analytics-tool --token YOUR_MIXPANEL_TOKEN

✨ 主要特性

• 集成Mixpanel分析工具
• 支持事件跟踪
• 用户注册和配置文件管理
• 详细日志记录

📦 安装指南

使用 npm 安装

npm install mixpanel-analytics-tool

从源代码构建

1. 克隆仓库：

git clone https://github.com/yourusername/mixpanel-analytics-tool.git
cd mixpanel-analytics-tool
npm install

💻 使用示例

基础用法

跟踪按钮点击

你: 可以在用户点击提交按钮时跟踪事件吗？

Claude: 我可以为您执行此操作。让我使用Mixpanel分析工具。

[Claude 使用 trackEvent 工具及其参数]

Claude: 成功在Mixpanel中记录了“button_click”事件，带有指定属性。

📚 详细文档

工具参考

trackEvent

跟踪用户事件。

• 参数:
  • event_name: 必需，事件名称。
  • properties: 可选，关联属性。

示例：

{
  "event_name": "button_click",
  "properties": {
    "button_id": "submit"
  }
}

trackSignup

跟踪用户注册并创建配置文件。

• 参数:
  • user_name: 必需，用户姓名。
  • email: 必需，用户邮箱。
  • plan: 可选，用户计划，默认为“免费”。

示例：

{
  "user_name": "张三",
  "email": "zhangsan@example.com",
  "plan": "付费"
}

setUserProfile

更新用户配置文件。

• 参数:
  • distinct_id: 必需，唯一标识符。
  • properties: 必需，属性值。

示例：

{
  "distinct_id": "user123",
  "properties": {
    "$name": "李四",
    "$email": "lisi@example.com",
    "plan": "付费",
    "公司": "科技有限公司"
  }
}

🔧 技术细节

故障排除

常见问题

1. 服务器未启动：

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

2. Claude Desktop未显示Mixpanel工具：

   • 验证claude_desktop_config.json文件语法。
   • 确保在编辑配置后重新启动了Claude Desktop。
   • 确认服务器路径正确无误。

3. 事件未显示在Mixpanel中：

   • 确认Mixpanel令牌有效。
   • 检查Mixpanel项目设置，确保数据接收正常。
   • 事件可能需要几分钟才能出现在界面中。

调试模式

以调试模式运行服务器以获取详细日志：

npx mixpanel-analytics-tool --token YOUR_MIXPANEL_TOKEN --debug

安全注意事项

• 您的Mixpanel令牌存储在Claude Desktop配置文件中。确保该文件权限适当。
• 考虑在生产环境中使用环境变量来管理令牌。
• 避免将敏感信息暴露在代码或日志中。

贡献指南

1. 克隆仓库：

git clone https://github.com/yourusername/mixpanel-analytics-tool.git
cd mixpanel-analytics-tool

2. 创建功能分支：

git checkout -b feature/new-feature

3. 提交更改：

git add .
git commit -m "添加新功能"
git push origin feature/new-feature

4. 开启拉取请求。

📄 许可证

MIT许可证