superset-mcp

Apache Superset用のMCP (Model Context Protocol) サーバーです。AIアシスタントに、Supersetインスタンス（ダッシュボード、チャート、データセット、データベース、SQL実行）へのフルアクセス権を与えます。

前提条件

uv — Pythonパッケージマネージャー
実行中のApache Supersetインスタンスへのアクセス権

セットアップ (所要時間: 約1分)

1. リポジトリのクローン

git clone <repo-url>
cd superset-mcp

2. 認証情報の設定

cp .env.example .env

.env を編集します:

SUPERSET_URL=http://your-superset-host:8088
SUPERSET_USERNAME=your-username
SUPERSET_PASSWORD=your-password

3. 動作確認

uv run superset-mcp

MCPサーバーがエラーなく起動することを確認してください。停止するには Ctrl+C を押します。

AIクライアントへの接続

/ABSOLUTE/PATH/TO/superset-mcp を、リポジトリをクローンした実際のパスに置き換えてください。

Claude Code

~/.claude/settings.json (またはプロジェクトレベルの .claude/settings.json) に追加します:

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

またはターミナルで実行します:

claude mcp add superset -- uv --directory /ABSOLUTE/PATH/TO/superset-mcp run superset-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に追加します:

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

プロジェクト内の .cursor/mcp.json またはグローバルの ~/.cursor/mcp.json に追加します:

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

利用可能なツール

ダッシュボード

ツール	説明
`list_dashboards`	すべてのダッシュボードを一覧表示 (検索オプションあり)
`get_dashboard`	IDまたはスラッグでダッシュボードを取得
`get_dashboard_charts`	ダッシュボード内のすべてのチャートを取得
`get_dashboard_datasets`	ダッシュボードで使用されているすべてのデータセットを取得
`create_dashboard`	新しいダッシュボードを作成
`update_dashboard`	タイトル、レイアウト、メタデータを更新
`publish_dashboard`	ドラフトのダッシュボードを公開
`copy_dashboard`	ダッシュボードを複製
`delete_dashboard`	ダッシュボードを削除

チャート

ツール	説明
`list_charts`	すべてのチャートを一覧表示 (検索オプションあり)
`get_chart`	IDまたはUUIDでチャートを取得
`get_chart_data`	チャートの最新データを取得
`create_chart`	新しいチャートを作成
`update_chart`	チャートのプロパティを更新
`delete_chart`	チャートを削除

データセット

ツール	説明
`list_datasets`	すべてのデータセットを一覧表示
`get_dataset`	IDまたはUUIDでデータセットを取得
`create_dataset`	テーブルまたはSQLクエリから作成
`get_or_create_dataset`	既存の取得、または新規作成
`refresh_dataset`	ソーステーブルからカラムを同期
`update_dataset`	データセットのプロパティを更新
`get_dataset_related_objects`	使用しているチャート/ダッシュボードを確認
`delete_dataset`	データセットを削除

データベース

ツール	説明
`list_databases`	すべてのデータベース接続を一覧表示
`get_database`	IDでデータベース接続を取得
`list_schemas`	データベース内のスキーマを一覧表示
`list_tables`	スキーマ内のテーブルを一覧表示
`get_table_metadata`	テーブルのカラム情報を取得
`get_select_star`	テーブルの SELECT * テンプレートを取得

SQL

ツール	説明
`execute_sql`	SQLクエリを実行して結果を取得
`format_sql`	SQLクエリを整形
`estimate_query_cost`	クエリコストを見積もる (サポートされている場合)
`list_saved_queries`	保存されたSQLクエリを一覧表示
`save_query`	SQLクエリを保存

プロンプト例

AIアシスタントに接続後、以下のように指示できます:

"公開されているすべてのダッシュボードをリストアップして"
"'Sales Overview'という新しいダッシュボードを作成して"
"ダッシュボード11に含まれるすべてのチャートを見せて"
"データベース2でSQLクエリを実行: SELECT count() FROM orders"*
"'Revenue'ダッシュボードではどのデータセットが使われている？"
"データセット5を使用して、地域別の売上を示す棒グラフを作成して"

superset-mcp

superset-mcp

前提条件

セットアップ (所要時間: 約1分)

1. リポジトリのクローン

2. 認証情報の設定

3. 動作確認

AIクライアントへの接続

Claude Code

Claude Desktop

Cursor

利用可能なツール

ダッシュボード

チャート

データセット

データベース

SQL

プロンプト例

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API