Mixpanel MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于将 Mixpanel 分析与 Claude 和其他 MCP 客户端集成。

功能

• 在 Mixpanel 中跟踪自定义事件
• 跟踪页面浏览量
• 跟踪用户注册
• 更新用户资料
• 遵循 MCP 规范的简单、清晰的实现

安装

前提条件

• Node.js 16.x 或更高版本
• npm 或 yarn
• 一个 Mixpanel 帐户和项目令牌

设置

1. 克隆存储库：

   git clone https://github.com/your-username/mixpanel-mcp-server.git
   cd mixpanel-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 使脚本可执行：

   chmod +x index.js
   

用法

运行服务器

直接运行服务器，提供您的 Mixpanel 令牌：

./index.js --token YOUR_MIXPANEL_TOKEN

对于详细日志记录：

./index.js --token YOUR_MIXPANEL_TOKEN --debug

安装以与 Claude Desktop 一起使用

1. 使服务器全局可访问（可选）：

   npm install -g .
   

2. 配置 Claude Desktop 以使用服务器：

   编辑您的 Claude Desktop 配置文件，该文件位于：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   添加以下配置：

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

   如果您没有全局安装，请指定完整路径：

   {
     "mcpServers": {
       "mixpanel-analytics": {
         "command": "node",
         "args": ["/path/to/mixpanel-mcp-new/index.js", "--token", "YOUR_MIXPANEL_TOKEN"]
       }
     }
   }
   

3. 重启 Claude Desktop

可用工具

连接后，以下工具将可供 Claude 使用：

• track_event: 在 Mixpanel 中跟踪自定义事件
• track_pageview: 跟踪页面浏览事件
• track_signup: 跟踪用户注册并创建个人资料
• set_user_profile: 更新用户的个人资料属性

测试

要测试服务器是否正常工作：

1. 在调试模式下运行它：

   ./index.js --token YOUR_MIXPANEL_TOKEN --debug
   

2. 使用 MCP Inspector 直接测试这些工具：

   npx @modelcontextprotocol/inspector server ./index.js --token YOUR_MIXPANEL_TOKEN
   

3. 检查您的 Mixpanel 仪表板以确认事件正在被记录。

故障排除

• 服务器立即退出：确保您提供的是有效的 Mixpanel 令牌。
• Claude 没有列出工具：验证您的 claude_desktop_config.json 是否配置正确。
• 事件未显示在 Mixpanel 中：事件可能需要一段时间才能显示在 Mixpanel UI 中。

许可证

MIT