framedash-mcp-server

@framedash/mcp-server

Framedash ゲームテレメトリープラットフォーム用の MCP（Model Context Protocol）サーバーです。LLM を活用したツールから分析データを照会するための、読み取り専用ツール 12 個とリソース 4 個を提供します。

セットアップ

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "framedash": {
      "command": "npx",
      "args": ["@framedash/mcp-server"],
      "env": {
        "FRAMEDASH_API_KEY": "fd_xxx",
        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

VS Code（Claude Extension）

VS Code の設定に追加します：

{
  "claude.mcpServers": {
    "framedash": {
      "command": "npx",
      "args": ["@framedash/mcp-server"],
      "env": {
        "FRAMEDASH_API_KEY": "fd_xxx",
        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

環境変数

変数	必須	説明
FRAMEDASH_API_KEY	はい	集計ツールには analytics:read を持つ API キーが必要です。生の query ツールには、さらに data:admin が必要です
FRAMEDASH_PROJECT_ID	いいえ	プロジェクト単位のツールで使用するデフォルトのプロジェクト UUID
FRAMEDASH_BASE_URL	いいえ	API のベース URL（デフォルト：https://app.framedash.dev）

FRAMEDASH_PROJECT_ID を省略しても、プロジェクト単位のツールは引き続き使用できますが、 呼び出しごとに明示的な project_id 引数が必要です。

ツール

ツール	説明
query	SQL 分析クエリを実行します（SELECT のみ。デフォルトの上限は 100）
get_dashboard	プロジェクトの KPI サマリー（DAU、MAU、セッション、イベント）
get_retention	コホートのリテンションデータ
get_funnel	イベントステップのファネル分析
get_insights	グループ化したイベントインサイト
get_heatmap	マップのヒートマップグリッドデータ
list_projects	API キーに紐付けられたプロジェクトを表示します
get_project_status	プロジェクトの健全性の概要
list_maps	プロジェクト内のマップ一覧
list_content	コンテンツレジストリのエントリー一覧
list_alerts	アラートルール一覧
get_alert_history	アラートの発火履歴

リソース

URI	説明
framedash://projects	API キーに紐付けられたプロジェクト
framedash://projects/{projectId}/maps	境界情報付きのマップ一覧
framedash://projects/{projectId}/content	コンテンツレジストリ
framedash://projects/{projectId}/status	プロジェクトの健全性ステータス

開発

リポジトリのルートから実行します：

pnpm install
pnpm --filter @framedash/mcp-server... build
pnpm --filter @framedash/mcp-server test

pnpm 9 では、末尾の ... によって、クリーンなチェックアウトからコンパイルする前に、@framedash/api-client を含む MCP パッケージとそのワークスペース依存関係が選択されます。

ライセンス

MIT