productmetrics

productmetrics

PostHog REST API と連携する、PostHog のプロダクト分析用 MCP ツールです。productmetrics は、PostHog MCP サーバーの中核機能を新しい名前でクリーンルーム方式により再構築したものです。コードは新規に作成されており、ブランド表現もコピーしていません。元のものは PostHog がホストするリモート MCP（OAuth）です。この再構築ではホスト型 OAuth は再現しておらず、同じ API を利用するパーソナル API キー対応の REST クライアントです。

ツール（中核機能の一部、12 個）

list_projects、get_project、list_insights、get_insight、 query_insight、run_hogql_query、list_feature_flags、 get_feature_flag、create_feature_flag、update_feature_flag、 list_experiments、get_experiment。

この中核機能には含まれないもの：イベントと人物、アクションとコホート、 アノテーション、ダッシュボード、データウェアハウス、エラートラッキング、アンケート、 セッション録画、サブスクリプション、組織の管理者向けツール。

セットアップ

PostHog でパーソナル API キーを作成し、設定します。

export POSTHOG_API_KEY=phx_...
export POSTHOG_PROJECT_ID=12345   # optional default project

必要に応じて、POSTHOG_HOST でホスト（たとえば EU ホスト）を上書きするか、 POSTHOG_API_BASE_URL でベース URL 全体を指定できます（デフォルトは https://app.posthog.com/api）。キーが設定されていない場合、すべてのツール呼び出しは、 不足している変数名を示すエラーで失敗します。呼び出しごとに project_id を渡すか、 POSTHOG_PROJECT_ID のフォールバックを利用してください。

CLI

npx @reneturcios/productmetrics list_projects '{}'
npx @reneturcios/productmetrics mcp        # stdio MCP server

各ツール名は、JSON オブジェクトを 1 つの引数として受け取るサブコマンドです。

MCP クライアントの設定

{
  "mcpServers": {
    "productmetrics": {
      "command": "npx",
      "args": ["-y", "@reneturcios/productmetrics", "mcp"],
      "env": { "POSTHOG_API_KEY": "phx_..." }
    }
  }
}

Docker

docker run -i -e POSTHOG_API_KEY ghcr.io/cloudcorprecords/productmetrics

開発

npm install
npm run build
npm test

ライセンス

MIT