スーパーセットMCP統合

Apache Superset と対話するための MCP サーバー。AI エージェントがプログラムで Superset インスタンスに接続して制御できるようにします。

セットアップ手順

Smithery経由でインストール

Smithery経由で Claude Desktop の Superset Integration を自動的にインストールするには:

npx -y @smithery/cli install @aptro/superset-mcp --client claude

手動インストール

ローカルでスーパーセットを設定するSuperset をローカルで起動するには、次のスクリプトを実行します。
git clone --branch 4.1.1 --depth 1 https://github.com/apache/superset && \ cd superset && \ docker compose -f docker-compose-image-tag.yml up
Superset が実行されると、デフォルトの資格情報を使用してhttp://localhost:8088にアクセスできるようになります。
- ユーザー名: admin
- パスワード: admin
このリポジトリをクローンするこのリポジトリをローカルマシンにクローンします。
環境変数を設定するSuperset の資格情報を使用して、ルートディレクトリに.envファイルを作成します。
SUPERSET_BASE_URL=http://localhost:8088 # Change to your Superset URL SUPERSET_USERNAME=your_username SUPERSET_PASSWORD=your_password
依存関係をインストールする
uv pip install .
Claude 用の MCP Config をインストールするClaude デスクトップアプリで使用するには:
mcp install main.py

クロードとの使用

セットアップ後、Claude を介して自然言語リクエストを使用して Superset インスタンスと対話できます。以下に例をいくつか示します。

ダッシュボード管理

ダッシュボードの表示: 「すべてのスーパーセットダッシュボードを表示する」
ダッシュボードの詳細を取得:「ID 5 のダッシュボードの詳細を表示」
ダッシュボードの作成：「「売上概要」というタイトルの新しいダッシュボードを作成します」
ダッシュボードを更新: 「ダッシュボード 3 を更新して、タイトルを「更新された売上レポート」にします」
ダッシュボードの削除:「ID 7 のダッシュボードを削除する」

チャート管理

すべてのチャートを一覧表示する: 「スーパーセットインスタンスにはどのようなチャートがありますか?」
チャートの詳細を表示: 「ID 10 のチャートの詳細を表示します」
グラフの作成：「データセット 3 を使用して新しい棒グラフを作成する」
チャートを更新: 「チャート 5 を更新して、棒グラフではなく折れ線グラフを使用する」
チャートの削除：「ID 12 のチャートを削除する」

データベースとデータセットの操作

データベースの一覧表示: 「Superset に接続されているすべてのデータベースを表示する」
データセットの一覧表示: 「私のスーパーセットインスタンスではどのようなデータセットが利用できますか?」
データベーステーブルを取得します。「ID 1 のデータベースで使用できるテーブルは何ですか?」
SQL を実行:「データベース 1 でこの SQL クエリを実行します: SELECT * FROM users LIMIT 10」
データセットの作成:「データベース 2 のテーブル 'customers' から新しいデータセットを作成する」
データベースの更新：「データベース3の接続設定を更新します」
データベースの削除:「ID 4のデータベース接続を削除します」
SQL を検証: 「この SQL はデータベース 2 に対して有効ですか: SELECT * FROM customers JOIN orders」
データベースカタログを取得する:「データベース 1 で利用可能なカタログを表示します」
データベース関数の取得:「データベース 2 ではどのような関数が利用できますか?」
関連オブジェクトの確認: 「どのダッシュボードとグラフがデータベース 1 を使用していますか?」

SQLラボの機能

クエリを実行する: 「この SQL クエリを実行します: SELECT COUNT(*) FROM orders」
SQL の形式: 「この SQL クエリの形式: SELECT id,name,age FROM users WHERE age>21」
クエリコストの見積もり: 「このクエリのコストを見積もります: SELECT * FROM large_table」
保存したクエリを取得する:「保存したすべての SQL クエリを表示する」
クエリ結果を取得:「キー 'abc123' のクエリ結果を取得します」

ユーザーおよびシステム情報

ユーザー情報の表示: 「私は誰としてログインしていますか?」
ユーザーロールの取得: 「Superset ではどのようなロールがありますか?」
最近のアクティビティを表示: 「スーパーセットインスタンスの最近のアクティビティを表示する」
メニューデータを取得:「どのメニュー項目にアクセスできますか?」
ベース URL の取得: 「接続しているスーパーセットインスタンスの URL は何ですか?」

タグ管理

タグの一覧表示: 「スーパーセットインスタンス内のすべてのタグを表示する」
タグを作成：「『金融』という新しいタグを作成する」
タグを削除：「ID 5のタグを削除します」
オブジェクトにタグを付ける: 「ダッシュボード 3 に「財務」タグを追加する」
タグを削除: 「チャート7から「財務」タグを削除します」

利用可能なMCPツール

このプラグインは、Claude が使用できる次の MCP ツールを提供します。

認証

superset_auth_check_token_validity - 現在のアクセストークンが有効かどうかを確認する
superset_auth_refresh_token - アクセストークンを更新する
superset_auth_authenticate_user - Supersetで認証する

ダッシュボード

superset_dashboard_list - すべてのダッシュボードを一覧表示する
superset_dashboard_get_by_id - 特定のダッシュボードを取得する
superset_dashboard_create - 新しいダッシュボードを作成する
superset_dashboard_update - 既存のダッシュボードを更新する
superset_dashboard_delete - ダッシュボードを削除する

チャート

superset_chart_list - すべてのチャートを一覧表示する
superset_chart_get_by_id - 特定のチャートを取得する
superset_chart_create - 新しいチャートを作成する
superset_chart_update - 既存のチャートを更新する
superset_chart_delete - チャートを削除する

データベース

superset_database_list - すべてのデータベースを一覧表示する
superset_database_get_by_id - 特定のデータベースを取得する
superset_database_create - 新しいデータベース接続を作成する
superset_database_get_tables - データベース内のテーブルを一覧表示する
superset_database_schemas - データベースのスキーマを取得する
superset_database_test_connection - データベース接続をテストする
superset_database_update - 既存のデータベース接続を更新する
superset_database_delete - データベース接続を削除する
superset_database_get_catalogs - データベースのカタログを取得する
superset_database_get_connection - データベース接続情報を取得する
superset_database_get_function_names - データベースでサポートされている関数名を取得する
superset_database_get_related_objects - データベースに関連付けられたチャートとダッシュボードを取得する
superset_database_validate_sql - データベースに対して任意のSQLを検証する
superset_database_validate_parameters - データベース接続パラメータを検証する

データセット

superset_dataset_list - すべてのデータセットを一覧表示する
superset_dataset_get_by_id - 特定のデータセットを取得する
superset_dataset_create - 新しいデータセットを作成する

SQLラボ

superset_sqllab_execute_query - SQLクエリを実行する
superset_sqllab_get_saved_queries - 保存された SQL クエリを一覧表示する
superset_sqllab_format_sql - SQLクエリをフォーマットする
superset_sqllab_get_results - クエリ結果を取得する
superset_sqllab_estimate_query_cost - クエリコストの見積もり
superset_sqllab_export_query_results - クエリ結果をCSVにエクスポートする
superset_sqllab_get_bootstrap_data - SQL Lab ブートストラップデータを取得する

クエリ

superset_query_list - すべてのクエリを一覧表示する
superset_query_get_by_id - 特定のクエリを取得する
superset_query_stop - 実行中のクエリを停止する

保存されたクエリ

superset_saved_query_get_by_id - 特定の保存済みクエリを取得する
superset_saved_query_create - 新しい保存クエリを作成する

ユーザー情報

superset_user_get_current - 現在のユーザー情報を取得する
superset_user_get_roles - ユーザーロールを取得する

活動

superset_activity_get_recent - 最近のアクティビティデータを取得する

システム

superset_menu_get - メニューデータを取得する
superset_config_get_base_url - スーパーセットインスタンスのベースURLを取得する

探索ツール

superset_explore_form_data_create - チャート探索用のフォームデータを作成する
superset_explore_form_data_get - チャート探索用のフォームデータを取得する
superset_explore_permalink_create - チャート探索用のパーマリンクを作成する
superset_explore_permalink_get - チャート探索用のパーマリンクを取得する

高度なデータ型

superset_advanced_data_type_convert - 値を高度なデータ型に変換する
superset_advanced_data_type_list - 利用可能な高度なデータ型を一覧表示する

環境変数

変数	説明	デフォルト
スーパーセットベースURL	スーパーセットインスタンスのURL	http://localhost:8088
スーパーセットユーザー名	Supersetのユーザー名	なし
スーパーセットパスワード	スーパーセットのパスワード	なし

トラブルシューティング

認証の問題が発生した場合は、 .envファイルで資格情報を確認してください。
Superset が実行されており、 .envファイルに指定された URL でアクセスできることを確認してください。
Superset の互換性のあるバージョンを使用していることを確認してください (バージョン 4.1.1 でテスト済み)
MCPサーバーが使用するポートが他のアプリケーションによって使用されていないことを確認します。

セキュリティノート

Superset の認証情報はローカルの.envファイルにのみ保存されます
アクセストークンはプロジェクトディレクトリの.superset_tokenファイルに保存されます。
すべての認証はMCPサーバーとSupersetインスタンス間で直接行われます
資格情報はクロードや第三者に送信されません
本番環境での使用には、より安全な認証方法の使用を検討してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学

Superset MCP Integration

Integrations