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許可證