Liquidium MCP サーバー

Liquidium を介して PostHog アナリティクスと連携するための Model Context Protocol (MCP) サーバー。Claude Desktop または Smithery から直接アノテーションを作成し、プロジェクトを管理できます。

特徴

• プロジェクトの一覧: 組織内で利用可能なすべての PostHog プロジェクトを表示します

• 注釈の作成: オプションのタイムスタンプを使用して、PostHogプロジェクトに注釈を追加します。

• インサイトの一覧表示と検索: PostHog プロジェクトのインサイトを表示および検索します

• インサイトの詳細を取得: 特定のインサイトに関する詳細情報を表示します

Related MCP server: PostHog MCP Server

設定

オプション 1: 鍛冶屋 (推奨)

Liquidium MCP を使用する最も簡単な方法は、Smithery を使用することです。

1. SmitheryのLiquidium MCPをご覧ください

2. 「Claudeに追加」をクリック

3. プロンプトが表示されたらPostHog APIキーを入力してください

4. Claude で Liquidium ツールを使い始めましょう!

オプション2: ローカルインストール

1. 前提条件

   • Python 3.10以上

   • pipまたはuvパッケージマネージャー

   • プロジェクト設定から取得したannotation:writeおよびproject:readスコープを含むPostHog APIキー

2. インストール

   # clone the repo
   git clone https://github.com/Shudufhadzo/liquidium-mcp.git
   
   cd liquidium-mcp
   
   # Create and activate virtual environment
   python -m venv .venv
   
   # On Windows
   .venv\Scripts\activate
   
   # On macOS/Linux
   source .venv/bin/activate
   
   # Install dependencies
   pip install -e .

3. 構成

   • プロジェクト ルートに.envファイルを作成します。

     PERSONAL_API_KEY=phx_your_posthog_api_key_here

4. クロードデスクトップセットアップ

   • Claude Desktopをインストールする

   • Claude Desktopの設定を開き、「設定の編集」をクリックします。または、以下の場所からファイルを開くこともできます。

     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

     • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • これをclaude_desktop_config.jsonに追加します (システムに応じてパスを調整してください)。

     {
       "mcpServers": {
         "posthog": {
           "command": "/path/to/python",  # Get this by running: which python
           "args": [
             "-m",
             "posthog_mcp",
             "--directory",
             "/path/to/your/posthog-mcp"  # Full path to this project
           ]
         }
       }
     }

     問題が発生した場合は、Claude Desktop を MCP クライアントとして設定する方法についての最新のドキュメントを確認してください。

使用法

セットアップ後、Claude Desktopにハンマーアイコンが表示されます。以下のコマンドが利用可能です。

プロジェクトの一覧

クロードに聞く:

"List my PostHog projects"

洞察の取得と検索

クロードに聞く:

「PostHogのインサイトを一覧表示する」または「PostHogで収益インサイトを検索する」

オンラインでドキュメントを検索する

次のように尋ねることができます。

• 「posthog の nextjs でリバース プロキシを実行するにはどうすればいいですか?」

注釈を作成

プロジェクト リストから取得したプロジェクト ID を使用して、Claude に質問します。

"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

または特定の日付で:

"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

トラブルシューティング

• ハンマーアイコンが表示されない場合は、Claude Desktopを再起動してください。

• ~/Library/Logs/Claude/mcp*.log (macOS) または%APPDATA%\Claude\logs (Windows) のログを確認します。

• PostHog APIキーに正しい権限があることを確認してください

• claude_desktop_config.json内のすべてのパスが絶対パスであることを確認してください

貢献

お気軽に問題や PR を投稿してください。PostHog の貢献ガイドラインに従っています。