bintocher/mcp-superset

bintocher/mcp-superset

от bintocher
MCP сервер для Apache Superset с 137 инструментами: управление дашбордами, отчетами, безопасностью (пользователи, роли, RLS). Встроенная защита — подтверждение опасных операций и блокировка DDL/DML. Автоматизирует работу аналитиков и администраторов через AI-ассистентов.

mcp-superset

PyPI version PyPI downloads Python 3.12+ License: MIT CI CodeQL

Superset 6.0.1 MCP Typed Ruff uv Tools: 137 GitHub stars

A comprehensive Model Context Protocol (MCP) server for Apache Superset. Gives AI assistants (Claude, GPT, etc.) full control over your Superset instance — dashboards, charts, datasets, SQL Lab, users, roles, RLS, and more — through 137 tools.

Comparison with Other Superset MCP Servers

Feature mcp-superset superset-mcp superset-mcp (Winding2020) superset-mcp-server
Total tools 137 60 31 4
Language Python Python TypeScript TypeScript
Dashboard CRUD 15 tools 5 8 -
Dashboard native filters 5 tools - - -
Chart CRUD 11 tools 5 7 -
Database tools 18 tools 14 1 1
Dataset tools 11 tools 3 7 -
SQL Lab 5 tools 7 1 1
Security (users/roles) 26 tools 2 - -
Row Level Security 5 tools - - -
Groups 9 tools - - -
Permissions audit yes - - -
Dashboard access grant/revoke yes - - -
Auto datasource_access sync yes - - -
Reports & annotations 10 tools - - -
Tags 7 tools 7 - -
Asset export/import yes - - -
Safety: confirmation flags 14 types - - -
Safety: DDL/DML blocking yes - - -
Safety: system role protection yes - - -
Transport HTTP, SSE, stdio stdio stdio stdio
Auth method JWT + auto-refresh + CSRF Username/password + token file Username/password or token LDAP
Superset versions 6.0.1 4.1.1 not specified not specified
CLI with args --host --port --transport - - -
PyPI package mcp-superset superset-mcp superset-mcp (npm) -
uvx support yes - - -
License MIT MIT - Apache 2.0
GitHub stars new 170 21 5
Инструменты были проиндексированы:
superset_annotation_create

Создаёт аннотацию (событие на временной шкале) в указанном слое. Аннотации отображаются в виде вертикальных линий или областей на графиках временных рядов.

Создает аннотацию Superset

Параметры
  • annotation_layer_idintegerобязательный

    Annotation layer ID (from annotation_layer_list).

  • end_dttmstringобязательный

    End datetime in ISO format. Example: "2024-01-01T23:59:59" For a point-in-time event, set start_dttm = end_dttm.

  • json_metadatastring | null

    JSON string with additional metadata (optional).

  • long_descrstring | null

    Detailed event description (optional).

  • short_descrstringобязательный

    Brief event description (displayed on the chart).

  • start_dttmstringобязательный

    Start datetime in ISO format. Example: "2024-01-01T00:00:00"

superset_annotation_delete

Удаляет аннотацию из слоя.

Удаление аннотации Superset

Параметры
  • annotation_idintegerобязательный

    Annotation ID to delete.

  • annotation_layer_idintegerобязательный

    Annotation layer ID.

  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

superset_annotation_get

Получает аннотацию по ID.

Получить аннотацию Superset.

Параметры
  • annotation_idintegerобязательный

    Annotation ID (from annotation_list).

  • annotation_layer_idintegerобязательный

    Annotation layer ID.

superset_annotation_layer_create

Создаёт новый слой аннотаций. Слой - это контейнер для аннотаций, которые можно накладывать на графики временных рядов.

Создание слоя аннотаций Superset

Параметры
  • descrstring | null

    Layer description (optional).

  • namestringобязательный

    Layer name.

superset_annotation_layer_delete

Удаляет слой аннотаций вместе со всеми его аннотациями. КРИТИЧЕСКИ ВАЖНО: удаляет слой И все аннотации внутри него навсегда.

Удалить слой аннотаций Superset

Параметры
  • annotation_layer_idintegerобязательный

    Layer ID to delete.

  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

superset_annotation_layer_get

Получите информацию о слое аннотаций по ID. ВАЖНО: если ID неизвестен, сначала вызовите annotation_layer_list.

Получить слой аннотаций Superset

Параметры
  • annotation_layer_idintegerобязательный

    Layer ID (from annotation_layer_list).

superset_annotation_layer_list

Перечисляет слои аннотаций. Слой аннотаций - это контейнер для аннотаций (событий временной шкалы), которые можно накладывать на графики.

Список слоев аннотаций Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

superset_annotation_layer_update

Обновляет слой аннотаций. Принимает только изменяемые поля.

Обновить слой аннотаций Superset

Параметры
  • annotation_layer_idintegerобязательный

    Layer ID to update.

  • descrstring | null

    New layer description.

  • namestring | null

    New layer name.

superset_annotation_list

Перечисляет аннотации в указанном слое.

Список аннотаций Superset

Параметры
  • annotation_layer_idintegerобязательный

    Annotation layer ID (from annotation_layer_list).

  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

superset_annotation_update

Обновите аннотацию. Передавайте только изменяемые поля.

Обновление аннотации Superset

Параметры
  • annotation_idintegerобязательный

    Annotation ID to update.

  • annotation_layer_idintegerобязательный

    Annotation layer ID.

  • end_dttmstring | null

    New end datetime (ISO format).

  • long_descrstring | null

    New detailed description.

  • short_descrstring | null

    New brief description.

  • start_dttmstring | null

    New start datetime (ISO format: "2024-01-01T00:00:00").

superset_assets_export

Экспортирует ВСЕ ресурсы Superset в один ZIP-файл. Включает: дашборды, диаграммы, наборы данных, подключения к базам данных (без паролей). Полезно для резервного копирования или переноса между инстансами. Возвращает: JSON: {"format": "zip", "encoding": "base64", "data": "...", "size_bytes": N}

Экспорт ресурсов Superset

Параметры

Без параметров.

superset_assets_import

Импортирует ресурсы Superset из ZIP-файла (созданного с помощью assets_export). КРИТИЧНО: overwrite=True перезаписывает ВСЕ соответствующие объекты (дашборды, диаграммы, наборы данных, базы данных). Это необратимо.

Импорт активов Superset

Параметры
  • confirm_overwriteboolean

    Overwrite confirmation (REQUIRED when overwrite=True).

  • file_pathstringобязательный

    Absolute path to the ZIP file on disk.

  • overwriteboolean

    Overwrite existing objects with matching UUIDs (default False).

superset_bulk_user_role_add

Добавляет роль нескольким пользователям (не удаляя существующие роли). Выбирает пользователей по явным ID или по фильтру текущей роли.

Массовое добавление ролей пользователям в Superset

Параметры
  • confirmboolean

    True to apply. False for dry-run.

  • exclude_adminboolean

    Skip Admin users (default True).

  • filter_role_idinteger | null

    Add to all users who have this role. Ignored if user_ids is set.

  • role_idintegerобязательный

    Role ID to add.

  • user_idsinteger[] | null

    Explicit list of user IDs. If None, uses filter_role_id.

superset_bulk_user_role_remove

Удаляет роль у нескольких пользователей.

Массовое удаление роли пользователя в Superset

Параметры
  • confirmboolean

    True to apply. False for dry-run.

  • exclude_adminboolean

    Skip Admin users (default True).

  • role_idintegerобязательный

    Role ID to remove.

  • user_idsinteger[] | null

    Explicit list of user IDs. If None, removes from ALL users who have it.

superset_bulk_user_role_replace

Заменяет одну роль на другую для всех пользователей, у которых она есть. Сначала добавляет new_role_id, затем удаляет old_role_id (безопасный двухшаговый процесс).

Массовая замена ролей пользователей в Superset

Параметры
  • confirmboolean

    True to apply. False for dry-run.

  • exclude_adminboolean

    Skip Admin users (default True).

  • new_role_idintegerобязательный

    Role ID to set instead.

  • old_role_idintegerобязательный

    Role ID to replace.

superset_chart_cache_warmup

Прогревает кеш для графика. Полезен для ускорения загрузки часто используемых графиков.

Прогрев кэша графиков Superset

Параметры
  • chart_idintegerобязательный

    ID of the chart to warm up.

  • dashboard_idinteger | null

    Dashboard ID for filter context (optional).

superset_chart_copy

Создаёт копию существующего графика с новым именем. Копирует все параметры визуализации, тип, набор данных и query_context. Привязки к панелям мониторинга НЕ копируются - укажите новые через параметр dashboards.

Копировать график Superset

Параметры
  • chart_idintegerобязательный

    ID of the source chart to copy.

  • dashboardsinteger[] | null

    List of dashboard IDs to bind the copy to (optional).

  • slice_namestringобязательный

    Name for the new copy.

superset_chart_create

Создаёт новую диаграмму.

Создание графика в Superset

Параметры
  • dashboardsinteger[] | null

    List of dashboard IDs to bind the chart to.

  • datasource_idintegerобязательный

    Dataset ID (from superset_dataset_list).

  • datasource_typestring

    Data source type (default "table" — dataset).

  • paramsstring | null

    JSON string with visualization parameters (depend on viz_type). Define metrics, groupings, filters, colors, labels, etc. IMPORTANT — numeric and time formats: Do NOT use SMART_NUMBER or SMART_DATE — they abbreviate numbers (1.61k instead of 1610) and show literal text instead of dates. Use explicit formats: - y_axis_format: "d" (integers without separators), ",d" (with commas), ",.2f" (decimals) - number_format: ",d" (for pie chart) - x_axis_time_format: "%b %Y" (X-axis dates), "%Y-%m-%d" (ISO) - tooltipTimeFormat: "%Y-%m-%d" or "%Y-%m" (tooltip dates) - show_value: true (show numbers on bar chart columns) CRITICAL — date/time format in Superset 6.x: Superset 6.x uses ONLY D3 time format (strftime syntax). Do NOT use moment.js format (YYYY-MM-DD) — it will be rendered as literal text "YYYY-MM-DD" instead of an actual date! Correct formats (D3/strftime): - "%Y-%m-%d" -> 2026-03-05 (ISO date) - "%Y-%m-%d %H:%M" -> 2026-03-05 14:30 (date + time) - "%d.%m.%Y" -> 05.03.2026 (European format) - "%b %Y" -> Mar 2026 (month + year) - "%Y" -> 2026 (year only) - "%Y-%m" -> 2026-03 (year-month) INCORRECT formats (moment.js — DO NOT WORK): - "YYYY-MM-DD" — renders literal "YYYY-MM-DD" - "DD.MM.YYYY" — renders literal "DD.MM.YYYY" - "MMM YYYY" — renders literal "MMM YYYY" Parameters that accept date formats: - table_timestamp_format (tables) - x_axis_time_format (X-axis) - tooltipTimeFormat (tooltip) - y_axis_format (for big_number_total with date in metric) big_number_total (KPI cards) — REFERENCE parameters: - header_font_size: 0.27 (number size, ~53px in a 60px container) - subheader_font_size: 0.15 (subtitle/label size) - y_axis_format: "d" (integers without comma separators) IMPORTANT — scroll in KPI: the big_number_total container has a fixed height (usually 60px at 2 grid cells). Too large a font causes scrolling. Culprits: font-size + line-height (1.1x) + margin-bottom (8px default). If using dashboard CSS for custom font size, add margin-bottom: 0 !important to .header-line. Formula: font_size * 1.1 + margin <= container_height (60px). Recommended CSS: font-size 3.3rem (58px with line-height), margin-bottom: 0. country_map — required parameters: - select_country: "russia" - entity: "<column with ISO 3166-2 codes>" - metric: {...} Map tooltip (class .hover-popup) is clipped by the container .dashboard-chart (overflow:hidden). Fix via dashboard CSS: .dashboard-chart-id-{N} .dashboard-chart { overflow: visible !important; } .hover-popup { z-index: 99999 !important; }

  • query_contextstring | null

    JSON string with query context. Required for chart_get_data to work. Usually generated by the UI.

  • slice_namestringобязательный

    Chart name (displayed in the UI).

  • viz_typestringобязательный

    Visualization type (Superset 6.x). Main types: ECharts (recommended): - echarts_timeseries_bar — bar/horizontal bar chart - echarts_timeseries_line — line chart - echarts_timeseries_smooth — smoothed line - echarts_timeseries_step — step line - echarts_timeseries_scatter — scatter plot - echarts_area — area chart - mixed_timeseries — multiple series with 2 Y-axes - pie — pie chart - funnel — funnel chart - gauge_chart — gauge/speedometer - radar — radar chart - graph_chart — graph/network - tree_chart — tree diagram - treemap_v2 — treemap - sunburst_v2 — sunburst chart - sankey_v2 — Sankey diagram - heatmap_v2 — heatmap - histogram_v2 — histogram - box_plot — box plot - bubble_v2 — bubble chart - waterfall — waterfall chart - gantt_chart — Gantt chart KPI: - big_number_total — big number (KPI) - big_number — KPI with trend Tables: - table — table - pivot_table_v2 — pivot table Maps: - country_map — country map (ISO 3166-2 codes) - world_map — world map Other: - word_cloud — word cloud - handlebars — custom template DEPRECATED (DO NOT USE — "not registered" error): dist_bar -> echarts_timeseries_bar, bar -> echarts_timeseries_bar, area -> echarts_area, line -> echarts_timeseries_line, heatmap -> heatmap_v2, histogram -> histogram_v2, treemap -> treemap_v2, sunburst -> sunburst_v2, sankey -> sankey_v2, pivot_table -> pivot_table_v2, dual_line -> mixed_timeseries, line_multi -> mixed_timeseries

superset_chart_data

Выполняет произвольный запрос к набору данных и получает данные. Позволяет получать данные напрямую из набора данных без создания графика. Чтобы получить данные из существующего графика, используйте chart_get_data.

Данные диаграммы Superset

Параметры
  • query_contextstringобязательный

    JSON string with the query context. Format: { "datasource": {"id": <dataset_id>, "type": "table"}, "queries": [{ "columns": ["col1", "col2"], "metrics": [{"label": "count", "expressionType": "SIMPLE", "aggregate": "COUNT", "column": {"column_name": "id"}}], "filters": [{"col": "status", "op": "==", "val": "active"}], "orderby": [["col1", true]], "row_limit": 100, "time_range": "Last 7 days" }], "result_format": "json", "result_type": "full" } IMPORTANT: time_range is specified at the QUERY level, NOT inside extras. Allowed time_range values: "Last day", "Last week", "Last month", "Last year", "No filter", or "2024-01-01 : 2024-12-31".

superset_chart_delete

Удаляет диаграмму по ID. Диаграмма будет удалена со всех панелей мониторинга.

Удаление диаграммы Superset

Параметры
  • chart_idintegerобязательный

    ID of the chart to delete.

  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

superset_chart_export

Экспортирует диаграммы со всеми зависимостями (наборами данных, базами данных) в виде ZIP-файла. Результат: ZIP-файл, закодированный в base64. Его можно импортировать обратно через superset_chart_import.

Экспорт графиков Superset

Параметры
  • chart_idsstringобязательный

    Chart IDs separated by commas (e.g. "1,2,3").

superset_chart_get

Получает подробную информацию о чарте по ID. Возвращает все настройки: viz_type, params, query_context, dashboard bindings. ВАЖНО: если ID неизвестен, сначала вызовите superset_chart_list.

Получает диаграмму Superset

Параметры
  • chart_idintegerобязательный

    Chart ID (integer from chart_list result).

superset_chart_get_data

Получает данные из конкретного сохраненного чарта по его ID. ВАЖНО: работает только если чарт был сохранен с query_context (обычно после открытия и сохранения через интерфейс Superset). Если query_context отсутствует, используйте superset_chart_data с вручную составленным запросом.

Получить данные диаграммы Superset

Параметры
  • chart_idintegerобязательный

    Chart ID.

superset_chart_import

Импортирует чарты из ZIP-файла (созданного через экспорт). ZIP-файл должен содержать YAML-файлы с конфигурациями и зависимостями чартов.

Импорт диаграмм Superset

Параметры
  • file_pathstringобязательный

    Absolute path to the ZIP file on disk.

  • overwriteboolean

    Overwrite existing objects with the same UUID (default False).

superset_chart_list

Перечисляет диаграммы Superset с пагинацией. ВАЖНО: всегда вызывайте этот инструмент перед chart_get/chart_delete, чтобы получить фактические идентификаторы диаграмм.

Список диаграмм Superset

Параметры
  • get_allboolean

    Retrieve ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for searching. Examples: - By name: (filters:!((col:slice_name,opr:ct,value:search_term))) - By type: (filters:!((col:viz_type,opr:eq,value:table))) - By dataset: (filters:!((col:datasource_id,opr:eq,value:1)))

superset_chart_update

Обновляет существующий график. Передавайте только поля для изменения.

Обновление диаграммы Superset

Параметры
  • chart_idintegerобязательный

    ID of the chart to update.

  • confirm_params_replaceboolean

    Confirmation for replacing params (REQUIRED when passing params).

  • dashboardsinteger[] | null

    New list of dashboard IDs (REPLACES all bindings).

  • paramsstring | null

    New JSON visualization parameters (replaces entirely). See chart_create for reference on numeric/time formats. IMPORTANT: params replaces ALL parameters — first get current ones via chart_get, modify the needed fields, and pass the full JSON. CRITICAL: for dates use D3 strftime format ("%Y-%m-%d"), NOT moment.js ("YYYY-MM-DD") — otherwise a literal will be shown!

  • query_contextstring | null

    New JSON query context (replaces entirely). IMPORTANT: when changing params you should also update query_context, otherwise the chart will use the old query context.

  • slice_namestring | null

    New name.

  • viz_typestring | null

    New visualization type (see chart_create for the list of types).

superset_dashboard_charts

Получает список всех графиков, размещённых на панели. Возвращает идентификаторы и названия графиков. Полезно для анализа содержимого панели.

Диаграммы дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_copy

Создаёт копию существующей панели мониторинга со всеми её графиками.

Копия дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    ID of the source dashboard to copy.

  • dashboard_titlestringобязательный

    Title for the new copy.

  • json_metadatastring | null

    JSON metadata for the copy. IMPORTANT: Superset requires this field. If not provided, "{}" will be used.

superset_dashboard_create

Создайте новую панель мониторинга. ВАЖНО: если указаны роли, datasource_access автоматически синхронизируется для указанных ролей: каждая роль получит доступ ко всем наборам данных панели мониторинга.

Создание дашборда Superset

Параметры
  • cssstring | null

    Custom CSS for dashboard styling.

  • dashboard_titlestringобязательный

    Dashboard title (displayed in the UI).

  • json_metadatastring | null

    JSON string with dashboard metadata. Contains filter settings, color palette, refresh interval. Use "{}" for empty metadata.

  • position_jsonstring | null

    JSON string with widget positioning on the dashboard. Defines the layout of charts, headers, dividers in the grid.

  • publishedboolean

    Publish immediately (default False — draft).

  • rolesinteger[] | null

    List of role IDs that can access the dashboard. Users without one of these roles will NOT see the dashboard. Empty list = accessible to all.

  • slugstring | null

    URL slug for a pretty link (e.g. "my-dashboard"). Must be unique.

superset_dashboard_datasets

Получает список всех наборов данных, используемых диаграммами дашборда. Полезно для понимания зависимостей дашборда от источников данных.

Наборы данных дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_delete

Удаляет дашборд по ID. Диаграммы и наборы данных НЕ удаляются - только сам дашборд. КРИТИЧНО: дашборд будет удалён навсегда.

Superset Dashboard Delete

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • dashboard_idintegerобязательный

    ID of the dashboard to delete.

superset_dashboard_embedded_delete

Отключает встраивание панели управления (встроенный режим). После отключения панель управления больше нельзя встроить через iframe.

Удаление встроенного дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_embedded_get

Получает настройки встраивания (embedded) панели мониторинга. ВАЖНО: возвращает 404, если режим встраивания не был настроен через embedded_set.

Получение встроенного дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_embedded_set

Включите встраивание дашборда (embedded mode) и настройте разрешённые домены. После включения дашборд можно встроить через iframe на указанных доменах.

Встроенный набор дашбордов Superset

Параметры
  • allowed_domainsstring[] | null

    List of domains where embedding is allowed (e.g. ["example.com", "app.example.com"]). Empty list = all domains.

  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_export

Экспортирует дашборды со всеми зависимостями (графики, наборы данных, базы данных) в ZIP. Результат: ZIP-файл в кодировке base64. Его можно импортировать обратно через superset_dashboard_import.

Экспорт дашборда Superset

Параметры
  • dashboard_idsstringобязательный

    Comma-separated dashboard IDs (e.g. "1,2,3").

superset_dashboard_filter_add

Добавляет нативный фильтр на дашборд с корректными настройками по умолчанию. Автоматически заполняет chartsInScope всеми диаграммами дашборда, строит корректные scope, defaultDataMask и cascadeParentIds. Идентификатор фильтра генерируется в формате NATIVE_FILTER-<uuid> — это ОБЯЗАТЕЛЬНО для Superset 6.0.1 (пользовательские ID молча игнорируются фронтендом).

Добавить фильтр на дашборд Superset

Параметры
  • cascade_parent_idstring | null

    ID of the parent filter for cascading.

  • columnstringобязательный

    Dataset column name for filtering (e.g. "full_name").

  • dashboard_idintegerобязательный

    Dashboard ID.

  • dataset_idintegerобязательный

    ID of the dataset providing filter values.

  • enable_empty_filterboolean

    Empty filter means filtering by NULL.

  • filter_typestring

    Filter type: "filter_select", "filter_time", "filter_range".

  • multi_selectboolean

    Allow multiple selection (default True).

  • namestringобязательный

    Display name of the filter (e.g. "Full Name").

  • search_all_optionsboolean

    Search all values, not just loaded ones (for large lists).

superset_dashboard_filter_delete

Удаляет нативный фильтр из дашборда по идентификатору.

Удаление фильтра дашборда Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • dashboard_idintegerобязательный

    Dashboard ID.

  • filter_idstringобязательный

    ID of the filter to delete (format "NATIVE_FILTER-<uuid>").

superset_dashboard_filter_list

Получает список нативных фильтров на дашборде в читаемом формате. Разбирает json_metadata и возвращает конфигурацию каждого фильтра: ID, name, type, column, dataset, chartsInScope.

Список фильтров дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_filter_reset

Воссоздаёт ВСЕ нативные фильтры на дашборде с правильными значениями по умолчанию. Удаляет все текущие фильтры и создаёт новые из предоставленного списка. Автоматически заполняет chartsInScope, scope, defaultDataMask, cascadeParentIds. КРИТИЧЕСКИ ВАЖНО: все текущие фильтры будут УДАЛЕНЫ и заменены новыми.

Сброс фильтра дашборда Superset

Параметры
  • confirm_resetboolean

    Filter reset confirmation (REQUIRED). { "name": "Full Name", "column": "full_name", "type": "filter_select", // filter_select | filter_time | filter_range "multi_select": true, // optional, default true "search_all_options": false, // optional, default false "enable_empty_filter": false, // optional, default false "cascade_parent_id": null // optional, parent filter ID }

  • dashboard_idintegerобязательный

    Dashboard ID.

  • dataset_idintegerобязательный

    Dataset ID for all filters.

  • filters_jsonstringобязательный

    JSON array of filter definitions. Each element:

superset_dashboard_filter_update

Обновляет нативный фильтр на панели управления по идентификатору. Передавайте только поля для изменения.

Обновление фильтра дашборда Superset

Параметры
  • cascade_parent_idstring | null

    Parent filter ID (None — remove cascading).

  • columnstring | null

    New column for filtering.

  • dashboard_idintegerобязательный

    Dashboard ID.

  • enable_empty_filterboolean | null

    Empty filter = NULL.

  • filter_idstringобязательный

    Filter ID (format "NATIVE_FILTER-<uuid>").

  • multi_selectboolean | null

    Multiple selection.

  • namestring | null

    New filter name.

  • search_all_optionsboolean | null

    Search all values.

superset_dashboard_get

Получает подробную информацию о дашборде по ID. ВАЖНО: если ID неизвестен, сначала вызовите superset_dashboard_list, чтобы найти нужный дашборд. Несуществующий ID вернёт 404.

Получает дашборд Superset.

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID (integer from dashboard_list result).

superset_dashboard_grant_role_access

Предоставляет роли доступ к дашборду, автоматически находя все наборы данных дашборда и добавляя datasource_access к разрешениям роли. Инструмент автоматически: 1. Находит все наборы данных, используемые в чартах дашборда 2. Находит permission_view_menu_id для datasource_access каждого набора данных 3. Проверяет, какие разрешения у роли уже есть 4. Добавляет отсутствующие datasource_access к существующим разрешениям роли 5. Проверяет правила RLS на наборах данных и предупреждает, если они отсутствуют Без confirm_grant=True показывает план действий (холостой прогон).

Предоставление доступа к дашборду Superset по ролям

Параметры
  • confirm_grantboolean

    True to apply changes. False for dry-run only.

  • dashboard_idintegerобязательный

    Dashboard ID (from dashboard_list).

  • role_idintegerобязательный

    ID of the role to grant access to (from role_list).

superset_dashboard_import

Импортирует панели мониторинга из ZIP-файла (созданного при экспорте). ZIP-файл должен содержать YAML-файлы с конфигурациями панелей мониторинга и зависимостей.

Параметры
  • file_pathstringобязательный

    Absolute path to the ZIP file on disk.

  • overwriteboolean

    Overwrite existing objects with the same UUID (default False).

superset_dashboard_list

Выводит список дашбордов Superset с пагинацией. ВАЖНО: всегда вызывайте этот инструмент перед dashboard_get, чтобы узнать текущие идентификаторы дашбордов.

Список дашбордов Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By title: (filters:!((col:dashboard_title,opr:ct,value:search))) - By owner: (filters:!((col:owners,opr:rel_m_m,value:1))) - Published only: (filters:!((col:published,opr:eq,value:!t)))

superset_dashboard_publish

Публикует дашборд (делает его видимым для пользователей с соответствующими разрешениями).

Публикация дашборда в Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_revoke_role_access

Отзывает доступ роли к дашборду, удаляя datasource_access для наборов данных этого дашборда из разрешений роли. ВАЖНО: если набор данных используется другими дашбордами, к которым у роли также есть доступ, отзыв доступа нарушит доступ и к этим дашбордам. Инструмент проверит и предупредит об этом. Без confirm_revoke=True показывает план действий (пробный запуск).

Superset Дашборд: отозвать доступ роли

Параметры
  • confirm_revokeboolean

    True to apply. False for dry-run only.

  • dashboard_idintegerобязательный

    Dashboard ID (from dashboard_list).

  • role_idintegerобязательный

    ID of the role to revoke access from (from role_list).

superset_dashboard_unpublish

Снять панель с публикации (преобразовать в черновик). Панель останется доступной для владельцев и администраторов, но будет скрыта из общего списка.

Снятие с публикации дашборда Superset

Параметры
  • dashboard_idintegerобязательный

    Dashboard ID.

superset_dashboard_update

Обновляет существующий дашборд. Передавайте только поля для изменения. ВАЖНО: после обновления datasource_access автоматически синхронизируется - каждая роль из dashboard.roles получит доступ ко всем наборам данных дашборда.

Обновление дашборда Superset

Параметры
  • cssstring | null

    New custom CSS for the dashboard. Injected as a <style> tag on the dashboard page. Does NOT affect Explore view (chart editor) — only the dashboard. Common CSS fixes: 1) KPI big_number_total — digit size and scroll: KPI container has a fixed height (~60px at 2 cells). Default font is small. To enlarge via CSS: div[class*="big_number"] .header-line { font-size: 3.3rem !important; /* digits / font-weight: 700 !important; line-height: 1.1 !important; margin-bottom: 0 !important; / REQUIRED! otherwise scroll / } div[class="big_number"] .subheader-line { font-size: 1rem !important; /* label */ font-weight: 400 !important; opacity: 0.7; } IMPORTANT: margin-bottom on .header-line defaults to 8px — together with line-height causes overflow and scroll. Verification formula: font_size_px * 1.1 + margin_bottom <= 60px. 3.3rem = 52.8px -> 52.8 * 1.1 = 58px + 0 = 58px < 60px OK 2) Country Map tooltip clipped by container — culprit is DIV.dashboard-chart (styled-component with overflow:hidden). Tooltip = DIV.hover-popup (NOT .datamaps-hoverover!). Fix: .dashboard-chart-id-{N} .dashboard-chart { overflow: visible !important; } .hover-popup { z-index: 99999 !important; } To analyze CSS issues: open the dashboard in Playwright, find the chart element, walk up parentElement, check getComputedStyle(el).overflow at each level.

  • dashboard_idintegerобязательный

    ID of the dashboard to update.

  • dashboard_titlestring | null

    New title.

  • json_metadatastring | object | null

    Dashboard JSON metadata (string or object, fully replaced).

  • ownersinteger[] | null

    List of owner user IDs (REPLACES all current owners).

  • position_jsonstring | object | null

    Widget positioning on the dashboard (string or object). Defines the layout of charts, headers, dividers in the grid. IMPORTANT: fully replaced — first get current layout via dashboard_get, modify needed elements and pass the entire JSON.

  • publishedboolean | null

    Change publication status (true — published, false — draft).

  • rolesinteger[] | null

    List of role IDs for dashboard access (REPLACES current ones). On change, datasource_access is automatically synced.

  • slugstring | null

    New URL slug (must be unique).

superset_database_available_engines

Перечисляет поддерживаемые типы движков баз данных для создания подключений. Возвращает доступные движки: PostgreSQL, MySQL, SQLite и т.д. Помогает выбрать движок при создании нового подключения.

Доступные движки баз данных Superset

Параметры

Без параметров.

superset_database_catalogs

Выводит список каталогов в базе данных (для движков, поддерживающих каталоги). Поддерживается не всеми движками. PostgreSQL и MySQL обычно не используют каталоги.

Каталоги баз данных Superset

Параметры
  • database_idintegerобязательный

    Database connection ID.

superset_database_connection_info

Получает информацию о подключении (URI без пароля и параметров).

Параметры подключения к базе данных Superset.

Параметры
  • database_idintegerобязательный

    Database connection ID.

superset_database_create

Создаёт новое подключение к базе данных. ВАЖНО: Superset проверяет доступность базы данных при создании. URI должен быть доступен с сервера Superset (не с localhost клиента).

Создание базы данных в Superset

Параметры
  • allow_ctasboolean

    Allow CREATE TABLE AS SELECT.

  • allow_cvasboolean

    Allow CREATE VIEW AS SELECT.

  • allow_dmlboolean

    Allow INSERT/UPDATE/DELETE.

  • allow_run_asyncboolean

    Allow asynchronous query execution.

  • database_namestringобязательный

    Human-readable connection name.

  • expose_in_sqllabboolean

    Whether to show in SQL Lab (default True).

  • extrastring | null

    JSON string with additional settings (engine_params, metadata_params).

  • sqlalchemy_uristringобязательный

    SQLAlchemy connection URI string. Examples: - PostgreSQL: postgresql://user:pass@host:5432/dbname - MySQL: mysql://user:pass@host:3306/dbname - SQLite: sqlite:///path/to/db.sqlite

superset_database_delete

Удаляет подключение к базе данных. Все связанные наборы данных станут нерабочими. КРИТИЧЕСКИ ВАЖНО: удаление подключения нарушает работу ВСЕХ наборов данных, диаграмм и панелей мониторинга, использующих эту БД.

Удаление базы данных Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • database_idintegerобязательный

    Connection ID to delete.

superset_database_export

Экспортирует конфигурации подключения к базе данных в ZIP-файл. ВАЖНО: пароли НЕ экспортируются по соображениям безопасности.

Экспорт базы данных Superset

Параметры
  • database_idsstringобязательный

    Comma-separated connection IDs (e.g. "1,2").

superset_database_function_names

Перечисляет доступные SQL-функции в базе данных. Полезно для построения SQL-запросов с функциями, специфичными для конкретного движка.

Имена функций базы данных Superset

Параметры
  • database_idintegerобязательный

    Database connection ID.

superset_database_get

Получает подробную информацию о подключении к базе данных по ID. ВАЖНО: если ID неизвестен, сначала вызовите superset_database_list.

Получить базу данных Superset

Параметры
  • database_idintegerобязательный

    Connection ID (integer from database_list result).

superset_database_list

Перечисляет подключения к базам данных, настроенные в Superset. Возвращает ID, название, тип движка и статус каждого подключения. ВАЖНО: всегда вызывайте перед database_get, чтобы узнать текущие ID.

Список баз данных Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for searching. Examples: - By name: (filters:!((col:database_name,opr:ct,value:postgres))) - By type: (filters:!((col:backend,opr:eq,value:postgresql)))

superset_database_related_objects

Получает объекты, связанные с подключением к базе данных (наборы данных, диаграммы). Полезно перед удалением подключения, чтобы понять, что сломается.

Объекты базы данных Superset

Параметры
  • database_idintegerобязательный

    Database connection ID.

superset_database_schemas

Выводит список схем, доступных в базе данных. Полезно для выбора схемы перед запросом таблиц или созданием набора данных.

Схемы базы данных Superset

Параметры
  • database_idintegerобязательный

    Database connection ID (from database_list).

superset_database_select_star

Генерирует SQL-запрос SELECT * для таблицы (с LIMIT). Полезно для быстрой проверки структуры и данных таблицы.

Выбор всех столбцов базы данных в Superset.

Параметры
  • database_idintegerобязательный

    Database connection ID.

  • schema_namestring | null

    Schema (e.g. "public"). If not specified, uses the default schema.

  • table_namestringобязательный

    Table name.

superset_database_table_metadata

Получает метаданные таблицы: столбцы, типы данных, индексы и первичные ключи. Полезно для понимания структуры таблицы перед написанием SQL-запросов.

Метаданные таблиц базы данных Superset

Параметры
  • database_idintegerобязательный

    Database connection ID.

  • schema_namestring | null

    Schema (e.g. "public"). If not specified, uses the default schema.

  • table_namestringобязательный

    Table name.

superset_database_tables

Перечисляет таблицы и представления в указанной схеме базы данных. Полезно для выбора таблицы перед созданием набора данных.

Таблицы базы данных Superset

Параметры
  • database_idintegerобязательный

    Database connection ID (from database_list).

  • schema_namestringобязательный

    Schema name (from database_schemas). Examples: "public", "source". Passed in RISON format without quotes.

superset_database_test_connection

Проверяет подключение к базе данных без её создания. ВАЖНО: URI должен быть доступен с сервера Superset.

Проверка подключения к базе данных Superset

Параметры
  • database_namestringобязательный

    Connection name (shown in error messages).

  • extrastring | null

    JSON string with additional settings.

  • sqlalchemy_uristringобязательный

    SQLAlchemy URI to test.

superset_database_update

Обновляет подключение к базе данных. Передавайте только те поля, которые хотите изменить.

Обновление базы данных Superset

Параметры
  • allow_ctasboolean | null

    Allow CREATE TABLE AS SELECT.

  • allow_cvasboolean | null

    Allow CREATE VIEW AS SELECT.

  • allow_dmlboolean | null

    Allow INSERT/UPDATE/DELETE.

  • confirm_uri_changeboolean

    Confirmation for URI change (REQUIRED when changing sqlalchemy_uri).

  • database_idintegerобязательный

    Connection ID to update.

  • database_namestring | null

    New connection name.

  • expose_in_sqllabboolean | null

    Whether to show in SQL Lab.

  • extrastring | null

    JSON string with additional settings.

  • sqlalchemy_uristring | null

    New SQLAlchemy URI. CRITICAL: changing the URI breaks all datasets and charts using this connection.

superset_database_validate_parameters

Проверяет параметры подключения к базе данных без создания подключения.

Проверка параметров базы данных Superset

Параметры
  • configuration_methodstring

    Configuration method: "sqlalchemy_form" (default) or "dynamic_form".

  • enginestringобязательный

    Database engine type: "postgresql", "mysql", "sqlite", "mssql", etc.

  • parametersobjectобязательный

    Connection parameters dictionary: {"host": "...", "port": 5432, "database": "...", "username": "...", "password": "..."}

superset_database_validate_sql

Проверяет синтаксис SQL-запроса без его выполнения (проверка, аналогичная EXPLAIN). ВАЖНО: не все СУБД поддерживают проверку SQL. PostgreSQL поддерживает.

Superset Проверка SQL базы данных

Параметры
  • database_idintegerобязательный

    Database connection ID.

  • schemastring | null

    Schema for validation context (e.g. "public").

  • sqlstringобязательный

    SQL query to validate.

superset_dataset_create

Создаёт новый набор данных (физический или виртуальный). Физический набор данных ссылается на существующую таблицу/представление в базе данных. Виртуальный набор данных использует произвольный SQL-запрос в качестве источника данных.

Создание набора данных Superset

Параметры
  • databaseintegerобязательный

    Database connection ID (from superset_database_list).

  • schema_namestring | null

    Database schema (e.g. "public", "source"). If omitted, uses the DB default schema.

  • sqlstring | null

    SQL query for a virtual dataset. If provided, creates a virtual dataset based on this query.

  • table_namestringобязательный

    Table/view name (for physical) or dataset name (for virtual).

superset_dataset_delete

Удаляет набор данных. Диаграммы, использующие этот набор данных, перестанут работать. КРИТИЧЕСКИ ВАЖНО: удаление набора данных нарушает работу всех связанных диаграмм и панелей мониторинга.

Удалить датасет Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • dataset_idintegerобязательный

    ID of the dataset to delete.

superset_dataset_duplicate

Создаёт копию существующего набора данных (с колонками и метриками).

Дубликат набора данных Superset

Параметры
  • base_model_idintegerобязательный

    ID of the source dataset to copy. IMPORTANT: the field is called base_model_id, NOT base_id or dataset_id.

  • table_namestringобязательный

    Name for the new dataset (must be unique).

superset_dataset_export

Экспортирует наборы данных с зависимостями (базы данных) в ZIP-файл. Результат — ZIP-файл в кодировке base64. Импортируется через dataset_import.

Экспорт датасета Superset

Параметры
  • dataset_idsstringобязательный

    Comma-separated dataset IDs (e.g. "1,2,3").

superset_dataset_get

Получает подробную информацию о датасете: столбцы, метрики, SQL. ВАЖНО: если идентификатор неизвестен, сначала вызовите superset_dataset_list.

Superset Dataset Get

Параметры
  • dataset_idintegerобязательный

    Dataset ID (integer from dataset_list result).

superset_dataset_get_or_create

Получает существующий набор данных или создаёт новый для таблицы. Если набор данных для указанной таблицы уже существует, возвращает его. Если нет, создаёт новый физический набор данных.

Superset Dataset Get Or Create

Параметры
  • database_idintegerобязательный

    Database connection ID (from superset_database_list).

  • schema_namestring | null

    Database schema (e.g. "public", "source"). If omitted, uses the DB default schema.

  • table_namestringобязательный

    Table name in the database.

superset_dataset_import

Импортирует наборы данных из ZIP-файла (созданного при экспорте).

Импорт наборов данных Superset

Параметры
  • file_pathstringобязательный

    Absolute path to the ZIP file on disk.

  • overwriteboolean

    Overwrite existing objects with matching UUIDs (default False).

superset_dataset_list

Выводит список наборов данных Superset с постраничной разбивкой. Набор данных: ссылка на таблицу/представление или виртуальный SQL-запрос в Superset. ВАЖНО: всегда вызывайте перед dataset_get, чтобы узнать текущие идентификаторы.

Superset Dataset List

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for searching. Examples: - By name: (filters:!((col:table_name,opr:ct,value:search_term))) - By schema: (filters:!((col:schema,opr:eq,value:public))) - By database: (filters:!((col:database,opr:rel_o_m,value:1)))

superset_dataset_refresh_schema

Обновляет схему набора данных из источника (повторно сканирует столбцы и типы). Полезно после ALTER TABLE или любого структурного изменения базовой таблицы.

Схема обновления датасета Superset

Параметры
  • dataset_idintegerобязательный

    Dataset ID.

superset_dataset_related_objects

Получает объекты, связанные с набором данных (диаграммы и дашборды). Полезно перед удалением набора данных, чтобы оценить последствия.

Связанные объекты датасетов Superset

Параметры
  • dataset_idintegerобязательный

    Dataset ID.

superset_dataset_update

Обновляет набор данных. Передавайте только те поля, которые хотите изменить.

Обновление датасета Superset

Параметры
  • always_filter_main_dttmboolean | null

    Force the dataset's main datetime filter on/off. Superset resets this flag to false on any PUT that omits it, which breaks dashboard time filters when only columns/metrics are updated. Pass an explicit value to set it; leave it None and the current value is preserved automatically whenever columns are replaced.

  • columnsstring | null

    JSON string describing columns. CRITICAL: passing columns REPLACES ALL dataset columns! To update a single column (e.g. verbose_name), pass ALL columns with their IDs. After an error, dataset_refresh_schema will restore columns from SQL. Format: [{"id": 123, "column_name": "id", "type": "INTEGER", ...}]

  • confirm_columns_replaceboolean

    Confirmation for replacing ALL columns (REQUIRED when passing columns).

  • dataset_idintegerобязательный

    ID of the dataset to update.

  • descriptionstring | null

    Dataset description (displayed in Superset UI).

  • metricsstring | null

    JSON string describing metrics. Format: [{"metric_name": "count", "expression": "COUNT(*)", "metric_type": "count"}]

  • sqlstring | null

    New SQL query (only for virtual datasets).

  • table_namestring | null

    New table/dataset name.

superset_get_base_url

Получает базовый URL настроенного экземпляра Superset. Возвращает URL, используемый MCP-сервером для подключения к Superset.

Получить базовый URL Superset

Параметры

Без параметров.

superset_get_current_user

Получает информацию о текущем аутентифицированном пользователе (mcp_service). Возвращает: JSON с полями username, name, email, roles и active status.

Получить текущего пользователя Superset

Параметры

Без параметров.

superset_get_current_user_roles

Получает список ролей для текущего пользователя (mcp_service). Возвращает: JSON с идентификаторами и названиями всех назначенных ролей.

Получить текущие роли пользователя Superset

Параметры

Без параметров.

superset_get_menu

Получает структуру навигационного меню Superset. Полезно для понимания доступных разделов и разрешений текущего пользователя.

Superset Получить меню

Параметры

Без параметров.

superset_group_add_roles

Добавляет роли в группу, не удаляя существующие.

Superset: Добавить роли в группу

Параметры
  • group_idintegerобязательный

    Group ID.

  • role_idsinteger[]обязательный

    List of role IDs to add.

superset_group_add_users

Добавляет пользователей в группу, не удаляя существующих. Удобный инструмент: получает текущих пользователей группы, объединяет с новыми и обновляет группу.

Superset Группа Добавить пользователей

Параметры
  • group_idintegerобязательный

    Group ID.

  • user_idsinteger[]обязательный

    List of user IDs to add.

superset_group_create

Создаёт новую группу пользователей. Группа объединяет пользователей и роли. Пользователи в группе автоматически наследуют все роли группы.

Создать группу Superset

Параметры
  • descriptionstring | null

    Group description.

  • labelstring | null

    Display label (e.g. "Moscow region").

  • namestringобязательный

    Unique group name (e.g. "la_region_Moscow").

  • rolesinteger[] | null

    List of role IDs to assign to the group.

  • usersinteger[] | null

    List of user IDs to add to the group.

superset_group_delete

Удаляет группу пользователей. Пользователи в группе НЕ удаляются, но они теряют роли, которые были назначены через эту группу.

Удаление группы Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • group_idintegerобязательный

    ID of the group to delete.

superset_group_get

Получает подробную информацию о группе по ID. Возвращает: имя, метку, описание, список ролей и пользователей.

Получает группу Superset.

Параметры
  • group_idintegerобязательный

    Group ID (from group_list).

superset_group_list

Перечисляет группы пользователей Superset. Группа объединяет пользователей и роли. Пользователи в группе наследуют все роли, назначенные группе.

Список групп Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination.

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By name: (filters:!((col:name,opr:ct,value:moscow)))

superset_group_remove_roles

Удаляет роли из группы, не удаляя остальные.

Удаляет роли группы Superset.

Параметры
  • group_idintegerобязательный

    Group ID.

  • role_idsinteger[]обязательный

    List of role IDs to remove.

superset_group_remove_users

Удаляет пользователей из группы, не удаляя остальных.

Удалить пользователей из группы Superset

Параметры
  • group_idintegerобязательный

    Group ID.

  • user_idsinteger[]обязательный

    List of user IDs to remove from the group.

superset_group_update

Обновите группу. Передавайте только поля, которые хотите изменить. ВАЖНО: roles ЗАМЕНЯЕТ весь список ролей группы (не добавляет к существующему). ВАЖНО: users ЗАМЕНЯЕТ весь список пользователей группы (не добавляет к существующему). Чтобы добавить одну роль/одного пользователя: получите текущие с помощью group_get, добавьте ID в список, передайте полный список.

Обновление группы в Superset

Параметры
  • confirm_roles_replaceboolean

    Confirmation for role replacement (REQUIRED when roles is set).

  • confirm_users_replaceboolean

    Confirmation for user replacement (REQUIRED when users is set).

  • descriptionstring | null

    New description.

  • group_idintegerобязательный

    ID of the group to update.

  • labelstring | null

    New label.

  • namestring | null

    New group name.

  • rolesinteger[] | null

    New COMPLETE list of role IDs (REPLACES all current ones).

  • usersinteger[] | null

    New COMPLETE list of user IDs (REPLACES all current ones).

superset_log_list

Получает аудиторский журнал всех действий пользователей Superset.

Список журналов Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By user: (filters:!((col:user,opr:rel_o_m,value:1))) - By action: (filters:!((col:action,opr:ct,value:explore)))

superset_permission_list

Получает список всех доступных разрешений (permission_view_menu) в Superset. Каждое разрешение состоит из действия (can_read, can_write, can_explore) и ресурса.

Список разрешений Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (defaults to 100).

  • qstring | null

    RISON filter for searching.

superset_permissions_audit

Аудит прав доступа: пользователь x / дашборды / наборы данных / матрица разрешений RLS. Для каждого пользователя показывает: - Группы, в которые он входит - Действующие роли (прямые + унаследованные от групп) - Доступ к каждому дашборду (1/0/partial) — проверяет ОБА условия: * Видимость дашборда (роль пользователя в dashboard.roles или roles пусты) * Доступ к данным (datasource_access ко ВСЕМ наборам данных) Значения: 1 = полный доступ, 0 = нет доступа, "visible_no_data" = можно открыть, но графики не работают - Доступ к каждому набору данных (1/0) - Доступные регионы через RLS

Аудит разрешений Superset

Параметры
  • include_adminboolean

    Include Admin users (they have access to everything).

  • pageinteger

    Results page (starting from 0).

  • page_sizeinteger

    Users per page (max 50).

  • username_filterstring | null

    Filter by username (substring match).

superset_query_get

Получает подробную информацию о запросе из истории по идентификатору.

Получает запрос Superset.

Параметры
  • query_idintegerобязательный

    Query ID (integer from query_list result).

superset_query_list

Получает историю выполненных SQL-запросов.

Список запросов Superset

Параметры
  • get_allboolean

    Retrieve ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By status: (filters:!((col:status,opr:eq,value:success))) - By database: (filters:!((col:database,opr:rel_o_m,value:1)))

superset_query_stop

Останавливает выполняющийся асинхронный запрос.

Остановка запроса в Superset

Параметры
  • query_idstringобязательный

    Query client_id to stop (string from sqllab_execute result).

superset_recent_activity

Получает последнюю активность текущего пользователя (просмотры, правки).

Недавняя активность Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

superset_report_create

Создайте отчет (периодическая доставка) или оповещение (на основе SQL-условия). Для отчета: укажите дашборд или диаграмму — Superset отправляет скриншот по расписанию. Для оповещения: укажите базу данных и SQL — Superset проверяет условие и уведомляет при срабатывании.

Создание отчёта Superset

Параметры
  • activeboolean

    Whether active (default True).

  • chartinteger | null

    Chart ID for screenshot (for Report).

  • crontabstringобязательный

    Cron schedule. Examples: - "0 9 * * *" — every day at 9:00 - "0 9 * * 1" — every Monday at 9:00 - "0 */6 * * *" — every 6 hours

  • dashboardinteger | null

    Dashboard ID for screenshot (for Report).

  • databaseinteger | null

    Database connection ID (for Alert — SQL condition).

  • namestringобязательный

    Report/alert name.

  • recipientsstring | null

    JSON string with recipient list. Format: [{"type": "Email", "recipient_config_json": {"target": "user@example.com"}}]

  • report_typestring

    Type: "Report" (periodic delivery, default) or "Alert" (condition-based).

  • sqlstring | null

    SQL query for condition check (for Alert). The alert triggers when the query returns a non-empty result.

superset_report_delete

Удаляет отчёт/оповещение. График доставки будет остановлен.

Удаляет отчет Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • report_idintegerобязательный

    Report ID to delete.

superset_report_get

Получает подробную информацию об отчёте/оповещении по ID. ВАЖНО: если ID неизвестен, сначала вызови superset_report_list.

Получить отчет Superset

Параметры
  • report_idintegerобязательный

    Report ID (integer from report_list result).

superset_report_list

Перечисляет отчёты и оповещения Superset. Отчёты отправляют периодические скриншоты дашбордов/диаграмм. Оповещения отправляют уведомления, когда выполняется условие SQL.

Список отчетов Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By name: (filters:!((col:name,opr:ct,value:search_term))) - By type: (filters:!((col:type,opr:eq,value:Report))) - Active only: (filters:!((col:active,opr:eq,value:!t)))

superset_report_update

Обновите отчёт/оповещение. Передавайте только изменяемые поля.

Обновление отчета Superset

Параметры
  • activeboolean | null

    Enable/disable the report.

  • crontabstring | null

    New cron schedule (e.g. "0 9 * * *").

  • namestring | null

    New name.

  • recipientsstring | null

    JSON string with new recipient list (REPLACES all current recipients).

  • report_idintegerобязательный

    Report ID to update.

superset_rls_create

Создаёт правило Row Level Security. RLS автоматически добавляет условие WHERE к запросам для пользователей с указанными ролями, обращающихся к указанным наборам данных.

Создание RLS в Superset

Параметры
  • clausestringобязательный

    SQL WHERE condition without the WHERE keyword. Examples: - "region = 'Moscow'" - "user_id = {{ current_user_id() }}" - "status IN ('active', 'pending')"

  • descriptionstring | null

    Rule description (optional).

  • filter_typestring

    Filter type: - "Regular" (default) — additional restriction for the specified roles - "Base" — base filter applied to all users

  • group_keystring | null

    Rule grouping key (optional).

  • namestringобязательный

    Rule name.

  • rolesinteger[]обязательный

    List of role IDs the rule applies to (from role_list).

  • tablesinteger[]обязательный

    List of dataset IDs the rule applies to (from dataset_list).

superset_rls_delete

Удаляет правило RLS. Ограничения для связанных ролей будут сняты. КРИТИЧЕСКИ ВАЖНО: удаление правила, запрещающего по умолчанию (clause='1=0'), немедленно откроет ВСЕ данные для пользователей с этими ролями.

Удаление RLS в Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • rls_idintegerобязательный

    ID of the RLS rule to delete.

superset_rls_get

Получает подробную информацию о правиле RLS по идентификатору.

Получить RLS в Superset

Параметры
  • rls_idintegerобязательный

    RLS rule ID (from rls_list).

superset_rls_list

Получает список правил Row Level Security. RLS добавляет предложение WHERE к запросам для определённых ролей.

Superset RLS List

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for searching.

superset_rls_update

Обновите правило RLS. КРИТИЧЕСКИ ВАЖНО: PUT-запрос Superset ПОЛНОСТЬЮ ЗАМЕНЯЕТ поля roles и tables. Если вы передадите только roles без tables, Superset ОЧИСТИТ tables пустым списком (и наоборот). Поэтому этот инструмент ТРЕБУЕТ одновременной передачи roles и tables, если указано хотя бы одно из них. Для безопасного обновления: 1. Сначала получите текущее правило через rls_list 2. Передайте И roles, И tables (даже если вы меняете только одно)

Обновление RLS в Superset

Параметры
  • clausestring | null

    New SQL WHERE condition (without the WHERE keyword).

  • descriptionstring | null

    New description.

  • filter_typestring | null

    New type: "Regular" or "Base".

  • group_keystring | null

    New grouping key.

  • namestring | null

    New name.

  • rls_idintegerобязательный

    ID of the RLS rule to update.

  • rolesinteger[] | null

    List of role IDs (REPLACES all current). REQUIRED if tables is specified.

  • tablesinteger[] | null

    List of dataset IDs (REPLACES all current). REQUIRED if roles is specified.

superset_role_copy_permissions

Копирует все разрешения из одной роли в другую (полная замена).

Копирование разрешений роли Superset

Параметры
  • confirmboolean

    True to apply. False for dry-run.

  • source_role_idintegerобязательный

    Role to copy permissions FROM.

  • target_role_idintegerобязательный

    Role to copy permissions TO (existing permissions will be REPLACED).

superset_role_create

Создаёт новую роль (без разрешений). Разрешения добавляются через role_permission_add.

Создание роли в Superset

Параметры
  • namestringобязательный

    Role name (must be unique).

superset_role_delete

Удаляет роль. Пользователи с этой ролью потеряют соответствующие разрешения. ЗАБЛОКИРОВАНО для системных ролей: Admin, Alpha, Gamma, Public, sql_lab, no_access, la_report_*, la_region_*, la_developer.

Удаление роли в Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • role_idintegerобязательный

    ID of the role to delete.

superset_role_get

Получает информацию о роли по идентификатору. ВАЖНО: если идентификатор неизвестен, сначала вызовите superset_role_list.

Получение роли Superset

Параметры
  • role_idintegerобязательный

    Role ID (integer from role_list result).

superset_role_list

Получает список ролей Superset. Стандартные роли: Admin, Alpha, Gamma, sql_lab, Public.

Список ролей Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for searching. Examples: - By name: (filters:!((col:name,opr:ct,value:admin)))

superset_role_permission_add

Устанавливает список разрешений для роли (ПОЛНАЯ ЗАМЕНА). ПРЕДУПРЕЖДЕНИЕ: этот endpoint ЗАМЕНЯЕТ ВСЕ разрешения роли на переданный список! Чтобы ДОБАВИТЬ одно разрешение: 1. Вызовите superset_role_permissions_get, чтобы получить текущие идентификаторы разрешений 2. Добавьте новый ID в список 3. Передайте ПОЛНЫЙ список в этот инструмент с параметром confirm_full_replace=True

Добавить разрешение роли

Параметры
  • confirm_full_replaceboolean

    Confirmation for full permission replacement (REQUIRED).

  • permission_view_menu_idsinteger[]обязательный

    FULL list of permission IDs for the role. Permission IDs can be obtained via superset_permission_list.

  • role_idintegerобязательный

    Role ID.

superset_role_permissions_get

Получает текущий список разрешений для роли. ВАЖНО: вызывайте это ДО role_permission_add, чтобы избежать потери существующих разрешений.

Получает разрешения ролей Superset.

Параметры
  • role_idintegerобязательный

    Role ID.

superset_role_update

Переименовывает роль.

Обновление роли в Superset

Параметры
  • namestringобязательный

    New role name.

  • role_idintegerобязательный

    ID of the role to rename.

superset_saved_query_create

Создаёт сохранённый SQL-запрос для повторного использования.

Создание сохраненного запроса в Superset

Параметры
  • db_idintegerобязательный

    Database connection ID (from superset_database_list).

  • descriptionstring | null

    Query description.

  • labelstringобязательный

    Query name (displayed in the list).

  • schemastring | null

    Default schema (e.g. "public").

  • sqlstringобязательный

    SQL query to save.

superset_saved_query_delete

Удаляет сохранённый запрос.

Удаление сохранённого запроса Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • saved_query_idintegerобязательный

    Saved query ID to delete.

superset_saved_query_get

Получает сохранённый запрос по ID: SQL-текст, схема, описание.

Superset Saved Query Get

Параметры
  • saved_query_idintegerобязательный

    Saved query ID (from saved_query_list).

superset_saved_query_list

Получает список сохранённых SQL-запросов.

Список сохранённых запросов Superset

Параметры
  • get_allboolean

    Retrieve ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By label: (filters:!((col:label,opr:ct,value:search_term))) - By database: (filters:!((col:database,opr:rel_o_m,value:1)))

superset_saved_query_update

Обновляет сохранённый запрос. Передавайте только поля для изменения.

Обновление сохранённого запроса Superset

Параметры
  • descriptionstring | null

    New description.

  • labelstring | null

    New name.

  • saved_query_idintegerобязательный

    Saved query ID.

  • schemastring | null

    New default schema.

  • sqlstring | null

    New SQL query.

superset_sqllab_estimate_cost

Оценивает стоимость выполнения SQL-запроса (EXPLAIN). Не все СУБД поддерживают эту возможность. PostgreSQL поддерживает.

Superset Sqllab Оценка стоимости

Параметры
  • database_idintegerобязательный

    Database connection ID.

  • schemastring | null

    Schema for context (e.g. "public").

  • sqlstringобязательный

    SQL query to estimate.

superset_sqllab_execute

Выполняет SQL-запрос через SQL Lab и возвращает результат. ВАЖНО: перед выполнением убедитесь, что SQL-запрос корректен. Используйте superset_database_table_metadata или superset_database_tables, чтобы найти актуальные имена таблиц и столбцов. Максимум 1000 строк в результате (queryLimit).

Superset Sqllab Выполнить

Параметры
  • catalogstring | null

    Database catalog (for databases with catalog support, optional).

  • database_idintegerобязательный

    Database connection ID (from superset_database_list).

  • schemastring | null

    Default schema for the query (e.g. "public", "source"). If not specified, the database default schema is used.

  • sqlstringобязательный

    SQL query to execute. Examples: - SELECT * FROM public.my_table LIMIT 10 - SELECT count(*) FROM source.stat

  • tab_namestring | null

    Tab name in SQL Lab UI (optional, for organization).

  • template_paramsstring | null

    JSON string with Jinja template parameters (optional). Example: '{"start_date": "2024-01-01"}'

superset_sqllab_export_csv

Экспортирует результаты запроса в формат CSV. ВАЖНО: требует настроенного бэкенда результатов (Redis/S3) в Superset.

Superset Sqllab: экспорт в CSV

Параметры
  • client_idstringобязательный

    Query client_id (from the superset_sqllab_execute result).

superset_sqllab_format_sql

Форматирует SQL-запрос (красивая печать с отступами).

Superset Sqllab Форматирует SQL

Параметры
  • sqlstringобязательный

    SQL query to format.

superset_sqllab_results

Получает результаты ранее выполненного запроса по ключу. ВАЖНО: требует настроенного хранилища результатов (Redis/S3) в Superset. Без него возвращает 500. Ключ берётся из поля results_key ответа sqllab_execute.

Результаты Superset Sqllab

Параметры
  • results_keystringобязательный

    Results key from the superset_sqllab_execute response.

superset_tag_bulk_create

Массово создаёт теги и прикрепляет их к объектам. Позволяет создавать несколько тегов и прикреплять их к объектам в одном запросе.

Массовое создание тегов в Superset

Параметры
  • tagsstringобязательный

    JSON string with a list of tags. Format: [ {"name": "production", "objects_to_tag": [["dashboard", 1], ["chart", 5]]}, {"name": "analytics", "objects_to_tag": [["dataset", 3]]} ] objects_to_tag: pairs of [object_type, object_id]. Allowed types: "dashboard", "chart", "dataset", "saved_query".

superset_tag_create

Создаёт новый тег и при необходимости прикрепляет его к объектам Superset. ВАЖНО: API Superset возвращает {} при создании (без идентификатора тега). Чтобы получить идентификатор нового тега, вызовите superset_tag_list после создания. Прикрепление объектов возможно только во время создания через objects_to_tag. Прямые конечные точки прикрепления (POST/DELETE /api/v1/tag/{type}/{id}/) не работают в версии 6.0.1.

Создать тег Superset

Параметры
  • descriptionstring | null

    Tag description (optional).

  • namestringобязательный

    Tag name.

  • objects_to_tagstring | null

    JSON string with a list of objects to tag. Format: [["dashboard", 1], ["chart", 5], ["dataset", 3], ["saved_query", 2]] Each element is a pair [object_type, object_id]. Allowed types: "dashboard", "chart", "dataset", "saved_query".

superset_tag_delete

Удаляет тег. Все прикреплённые объекты будут удалены.

Удалить тег Superset

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • tag_idintegerобязательный

    Tag ID to delete.

superset_tag_get

Получает информацию о теге по идентификатору. ВАЖНО: если идентификатор неизвестен, сначала вызовите superset_tag_list.

Получить тег Superset

Параметры
  • tag_idintegerобязательный

    Tag ID (integer from tag_list result).

superset_tag_get_objects

Получает объекты, помеченные указанными тегами. Возвращает панели управления, диаграммы, наборы данных и запросы с указанными тегами.

Superset Tag Get Objects

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • tagsstring | null

    Comma-separated tag names (e.g. "analytics,production"). If not specified, returns all tagged objects.

superset_tag_list

Перечисляет теги Superset. Теги группируют и упорядочивают дэшборды, диаграммы и наборы данных. ВАЖНО: всегда вызывайте перед tag_get/tag_update, чтобы найти текущие ID. При создании тега API возвращает {} без ID, используйте tag_list, чтобы получить ID.

Список тегов надмножества

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for search. Examples: - By name: (filters:!((col:name,opr:ct,value:search_term)))

superset_tag_update

Обновляет тег (переименовывает или меняет описание). ВАЖНО: поле name ОБЯЗАТЕЛЬНО в Superset 6.0.1, даже если имя не меняется, его необходимо указать. Без него Superset возвращает 500.

Обновление тегов Superset

Параметры
  • descriptionstring | null

    New description (optional).

  • namestringобязательный

    Tag name (REQUIRED, even if unchanged).

  • tag_idintegerобязательный

    Tag ID to update.

superset_user_create

Создаёт нового пользователя Superset.

Создать пользователя Superset

Параметры
  • activeboolean

    Whether the account is active (defaults to True).

  • emailstringобязательный

    Email address (must be unique).

  • first_namestringобязательный

    User's first name.

  • last_namestringобязательный

    User's last name.

  • passwordstringобязательный

    Password.

  • rolesinteger[] | null

    List of role IDs to assign (from superset_role_list). If not specified, the default role (Public) will be assigned.

  • usernamestringобязательный

    Login name (must be unique).

superset_user_delete

Удаляет пользователя Superset. Эта операция необратима. КРИТИЧЕСКИ ВАЖНО: удаление текущего сервисного аккаунта (mcp_service) заблокирует весь MCP-сервер. Удаление владельцев дашбордов может изменить доступ к этим дашбордам.

Superset User Delete

Параметры
  • confirm_deleteboolean

    Deletion confirmation (REQUIRED).

  • user_idintegerобязательный

    ID of the user to delete.

superset_user_get

Получает подробную информацию о пользователе по ID. ВАЖНО: если ID неизвестен, сначала вызовите superset_user_list.

Получение пользователя Superset

Параметры
  • user_idintegerобязательный

    User ID (integer from user_list result).

superset_user_list

Получает список пользователей Superset.

Список пользователей Superset

Параметры
  • get_allboolean

    Fetch ALL records with automatic pagination (ignores page/page_size).

  • pageinteger

    Page number (starting from 0).

  • page_sizeinteger

    Number of records per page (max 100).

  • qstring | null

    RISON filter for searching. Examples: - By username: (filters:!((col:username,opr:ct,value:admin))) - Active only: (filters:!((col:active,opr:eq,value:!t))) - By role: (filters:!((col:roles,opr:rel_m_m,value:1)))

superset_user_update

Обновляет пользователя. Передавайте только те поля, которые хотите изменить. ВАЖНО: roles ЗАМЕНЯЕТ весь список ролей (не добавляет). Чтобы добавить одну роль: получите текущие роли через user_get, добавьте новый идентификатор в список, затем передайте полный список.

Обновление для пользователей Superset

Параметры
  • activeboolean | null

    Activate/deactivate the account.

  • confirm_roles_replaceboolean

    Confirmation for role replacement (REQUIRED when passing roles).

  • emailstring | null

    New email (must be unique).

  • first_namestring | null

    New first name.

  • last_namestring | null

    New last name.

  • rolesinteger[] | null

    New list of role IDs (REPLACES all current roles).

  • user_idintegerобязательный

    ID of the user to update.

Похожие MCP-сервера

seob717/redash-mcp

seob717/redash-mcp

MCP-сервер для безопасного подключения Redash к Claude AI. BIRD Smart Query анализирует вопросы, подбирает таблицы и генерирует SQL. Встроенный SQL Safety Guard блокирует опасные операции. Для анал...

TypeScript1
rashidazarang/airtable-mcp

rashidazarang/airtable-mcp

MCP-сервер для Airtable с CRUD, управлением схемой и AI-аналитикой. Поддерживает вебхуки и пакетные операции. Помогает разработчикам и AI-агентам автоматизировать работу с данными.

TypeScript87
iunera/druid-mcp-server

iunera/druid-mcp-server

MCP-сервер для Apache Druid: инструменты, ресурсы и промпты для управления кластерами, SQL-запросов, настройки ингредиентов и мониторинга здоровья. Даёт AI-ассистентам возможность управлять и анали...

Java18
xing5/mcp-google-sheets

xing5/mcp-google-sheets

MCP сервер для интеграции Google Sheets с AI-ассистентами. Позволяет читать, писать и обновлять таблицы, искать данные, управлять листами и выполнять пакетные операции. Полезен разработчикам и аналитикам для автоматизации работы с электронными таблицами через естественный язык.

Python998
wenb1n-dev/mysql_mcp_server_pro

wenb1n-dev/mysql_mcp_server_pro

mcp_mysql_server_pro — это MCP-сервер для работы с MySQL: выполняет SQL-запросы, анализирует аномалии и здоровье базы, проверяет блокировки и предлагает оптимизацию. Поддерживает OAuth2.0, три роли...

Python248
apache/doris-mcp-server

apache/doris-mcp-server

MCP сервер для подключения к Apache Doris. Преобразует запросы на естественном языке в SQL (NL2SQL), выполняет аналитические запросы и управляет метаданными. Идеален для дата-аналитиков и разработчиков, использующих LLM.

Python343
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин