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: 指定された属性を持つ「button_click」イベントがMixpanelに正常に記録されました。

📚 ドキュメント

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ライセンス