STARWARCLOUD STARWAR.AI
返回市场
混合面板MCP服务器

混合面板MCP服务器

作者：moonbirdai5 星标更新：2025-04-18
安装使用来源：spider==github.com

项目介绍

Mixpanel MCP Server

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

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

目录

功能

  • 在Mixpanel中跟踪自定义事件
  • 跟踪带有来源信息的页面浏览量
  • 跟踪用户注册并创建用户资料
  • 更新现有用户资料
  • 简单地与Claude Desktop和其他MCP客户端集成

安装

先决条件

  • Node.js 16或更高版本
  • 一个Mixpanel项目令牌（通过在Mixpanel注册获取）

NPM安装（推荐）

# 全局安装
npm install -g mixpanel-mcp-server

# 或直接使用npx
npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

手动安装

# 克隆仓库
git clone https://github.com/yourusername/mixpanel-mcp-server.git
cd mixpanel-m-服务器

# 安装依赖
npm install

# 运行服务器
node index.js --token YOUR_MIXPANEL_TOKEN

快速开始

要开始使用Mixpanel MCP服务器与Claude Desktop：

  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"
      ]
    }
  }
}
  1. 重启Claude Desktop并开始跟踪分析！

详细使用

与Claude Desktop一起使用

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

您可以使用的提示示例如下：

  • "在Mixpanel中为用户'user123'跟踪名为'document_generated'的自定义事件"
  • "在Mixpanel中跟踪主页的页面浏览量"
  • "在Mixpanel中为John Doe创建新的用户资料，电子邮件地址为john@example.com"
  • "在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": "john@example.com",
  "plan": "premium"
}

mixpanel_set_user_profile

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

参数：

  • distinct_id (字符串，必需)：用户标识符
  • properties (对象，必需)：要设置的资料属性

示例：

{
  "distinct_id": "user123",
  "properties": {
    "$name": "John Doe",
    "$email": "john@example.com",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

示例

这里有一些使用Mixpanel MCP服务器与Claude的实际示例：

跟踪按钮点击

您：当用户点击提交按钮时，能否在Mixpanel中跟踪该事件？

Claude：我将为您跟踪该事件。让我使用Mixpanel分析工具。

[Claude使用适当的参数使用mixpanel_track_event工具]

Claude：我已经成功在Mixpanel中跟踪了'button_clicked'事件，并设置了您指定的属性。

创建用户资料

您：在Mixpanel中为Sarah Johnson创建一个新的用户资料，她用sarah@example.com注册了高级计划。

Claude：我将在Mixpanel中创建那个用户资料。

[Claude使用适当的参数使用mixpanel_track_signup工具]

Claude：我已经成功跟踪了Sarah Johnson的注册，并在Mixpanel中创建了一个高级计划的资料。

故障排除

常见问题

  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. 分叉仓库
  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文件了解详情。