Mixpanel MCP Server

Mixpanel MCP サーバー

AI ワークフローに Mixpanel アナリティクスを統合するための Model Context Protocol (MCP) サーバーです。このサーバーを使うと、Claude などの AI アシスタントで、イベント、ページビュー、ユーザー登録のトラッキングや、Mixpanel のユーザープロフィールの更新ができます。

バージョン 2.0.1 の注記： 他のアナリティクス MCP サーバーとの名前空間の衝突を防ぐため、ツール名に mixpanel_ のプレフィックスが付くようになりました。

目次

• 機能
• インストール
• クイックスタート
• 詳しい使い方
  • Claude Desktop を使う
  • 他の MCP クライアントを使う
• ツールリファレンス
• 使用例
• トラブルシューティング
• セキュリティに関する注記
• コントリビューション
• ライセンス

機能

• Mixpanel でカスタムイベントをトラッキング
• リファラー情報を含むページビューをトラッキング
• ユーザー登録をトラッキングし、ユーザープロフィールを作成
• 既存のユーザープロフィールを更新
• Claude Desktop や他の MCP クライアントと簡単に統合

インストール

前提条件

• Node.js 16 以降
• Mixpanel プロジェクトトークン（Mixpanel に登録すると取得できます）

NPM によるインストール（推奨）

# Install globally
npm install -g mixpanel-mcp-server

# Or use directly with npx
npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

手動インストール

# Clone the repository
git clone https://github.com/yourusername/mixpanel-mcp-server.git
cd mixpanel-mcp-server

# Install dependencies
npm install

# Run the server
node index.js --token YOUR_MIXPANEL_TOKEN

クイックスタート

Claude Desktop で Mixpanel MCP サーバーを使い始めるには：

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"
      ]
    }
  }
}

4. Claude Desktop を再起動して、アナリティクスのトラッキングを始めましょう！

詳しい使い方

Claude Desktop を使う

クイックスタートのセクションの手順に従って設定ファイルをセットアップすると、Claude との会話で Mixpanel のアナリティクス機能を直接利用できます。

使用できるプロンプトの例：

• 「ユーザー 'user123' の 'document_generated' という名前のカスタムイベントを Mixpanel でトラッキングして」
• 「Mixpanel でホームページのページビューをトラッキングして」
• 「Mixpanel で John Doe の新しいユーザープロフィールを作成して。メールアドレスは [email protected]」
• 「Mixpanel でユーザー 'user123' のプロフィール情報を更新して」

Claude はリクエストに応じて、適切な Mixpanel MCP ツールを使用します。

他の MCP クライアントを使う

このサーバーは標準の Model Context Protocol を使用しているため、あらゆる 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（string、必須）：トラッキングするイベントの名前
• distinct_id（string、省略可）：ユーザー識別子。デフォルトは 'anonymous' です
• properties（object、省略可）：イベントとともにトラッキングする追加のプロパティ

例：

{
  "event_name": "button_clicked",
  "distinct_id": "user123",
  "properties": {
    "button_id": "submit_form",
    "page": "checkout"
  }
}

mixpanel_track_pageview

Mixpanel でページビューイベントをトラッキングします。

パラメーター：

• page_name（string、必須）：閲覧したページの名前
• distinct_id（string、省略可）：ユーザー識別子。デフォルトは 'anonymous' です
• referrer（string、省略可）：参照元のページ

例：

{
  "page_name": "homepage",
  "distinct_id": "user123",
  "referrer": "google.com"
}

mixpanel_track_signup

登録イベントをトラッキングし、Mixpanel でユーザープロフィールを作成します。

パラメーター：

• user_name（string、必須）：ユーザーの氏名
• email（string、必須）：ユーザーのメールアドレス
• plan（string、省略可）：登録プラン。デフォルトは 'free' です

例：

{
  "user_name": "John Doe",
  "email": "[email protected]",
  "plan": "premium"
}

mixpanel_set_user_profile

Mixpanel のユーザープロフィールのプロパティを更新します。

パラメーター：

• distinct_id (string, required)：ユーザー識別子
• properties (object, required)：設定するプロフィールのプロパティ

例：

{
  "distinct_id": "user123",
  "properties": {
    "$name": "John Doe",
    "$email": "[email protected]",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

使用例

Claude で Mixpanel MCP サーバーを使用する実践的な例を紹介します。

ボタンクリックのトラッキング

You: Can you track an event in Mixpanel when a user clicks the submit button?

Claude: I'll track that event for you. Let me use the Mixpanel analytics tool.

[Claude uses the mixpanel_track_event tool with appropriate parameters]

Claude: I've successfully tracked the 'button_clicked' event in Mixpanel with the properties you specified.

ユーザープロフィールの作成

You: Create a new user profile in Mixpanel for Sarah Johnson who signed up with [email protected] on the premium plan.

Claude: I'll create that user profile in Mixpanel.

[Claude uses the mixpanel_track_signup tool with appropriate parameters]

Claude: I've successfully tracked the signup for Sarah Johnson and created a profile in Mixpanel with the premium plan.

トラブルシューティング

よくある問題

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 のプライバシーポリシーを確認してください

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルを参照してください。