Для чего этот сервер?

Этот MCP-сервер подключает AI-ассистентов к Apache Superset и даёт им полный контроль над BI-платформой. Через 137 инструментов AI может создавать дашборды и графики, управлять базами данных и наборами данных, выполнять SQL-запросы, настраивать пользователей и роли, выдавать права доступа. Сервер решает задачу автоматизации администрирования Superset: вместо ручных действий через веб-интерфейс AI делает всё сам, включая сложные операции по безопасности и аудиту.

Что он умеет?

Сервер управляет дашбордами: создаёт, копирует, обновляет, публикует, удаляет, добавляет фильтры и настройки встраивания. Работает с чартами, датасетами и подключениями к базам: создаёт, обновляет, дублирует, удаляет, экспортирует и импортирует, читает схемы и таблицы. Выполняет SQL-запросы, возвращает результаты, форматирует и оценивает стоимость. Ведёт пользователей, роли, группы, разрешения и RLS-правила, управляет отчётами, тегами, аннотациями, читает аудит-лог и недавнюю активность.

Каталог MCP
bintocher/mcp-superset

bintocher/mcp-superset

от bintocher

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

Github PyPi Сайт сервера

README

137 инструментов

Версии

Установить сервер

mcp-superset

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

Часто задаваемые вопросы

Инструменты были проиндексированы: 15.10.2026

superset_annotation_create

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

Параметры

annotation_layer_idintegerобязательный
Идентификатор слоя аннотаций (из annotation_layer_list).
end_dttmstringобязательный
Конечная дата и время в формате ISO. Пример: "2024-01-01T23:59:59" Для события, происходящего в конкретный момент времени, установите start_dttm = end_dttm.
json_metadatastring | null
JSON-строка с дополнительными метаданными (необязательно).
long_descrstring | null
Подробное описание события (необязательно).
short_descrstringобязательный
Краткое описание события (отображается на графике).
start_dttmstringобязательный
Начальная дата и время в формате ISO. Пример: "2024-01-01T00:00:00"

superset_annotation_delete

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

Параметры

annotation_idintegerобязательный
ID аннотации для удаления.
annotation_layer_idintegerобязательный
Идентификатор слоя аннотаций.
confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).

superset_annotation_get

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

Параметры

annotation_idintegerобязательный
Идентификатор аннотации (из annotation_list).
annotation_layer_idintegerобязательный
Идентификатор слоя аннотаций.

superset_annotation_layer_create

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

Параметры

descrstring | null
Описание слоя (необязательно).
namestringобязательный
Имя слоя.

superset_annotation_layer_delete

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

Параметры

annotation_layer_idintegerобязательный
ID слоя, который нужно удалить.
confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).

superset_annotation_layer_get

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

Параметры

annotation_layer_idintegerобязательный
Идентификатор слоя (из annotation_layer_list).

superset_annotation_layer_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).

superset_annotation_layer_update

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

Параметры

annotation_layer_idintegerобязательный
Идентификатор слоя для обновления.
descrstring | null
namestring | null
Имя нового слоя.

superset_annotation_list

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

Параметры

annotation_layer_idintegerобязательный
Идентификатор слоя аннотаций (из annotation_layer_list).
get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).

superset_annotation_update

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

Параметры

annotation_idintegerобязательный
Идентификатор аннотации для обновления
annotation_layer_idintegerобязательный
Идентификатор слоя аннотаций.
end_dttmstring | null
Новая дата и время окончания (формат ISO).
long_descrstring | null
Новое подробное описание.
short_descrstring | null
Новое краткое описание.
start_dttmstring | null
Новая дата и время начала (формат ISO: "2024-01-01T00:00:00").

superset_assets_export

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

Параметры

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

superset_assets_import

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

Параметры

confirm_overwriteboolean
Подтверждение перезаписи (ОБЯЗАТЕЛЬНО, когда overwrite=True).
file_pathstringобязательный
Абсолютный путь к ZIP-файлу на диске.
overwriteboolean
Перезаписывает существующие объекты с совпадающими UUID (по умолчанию False).

superset_bulk_user_role_add

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

Параметры

confirmboolean
True применяет изменения. False используется для пробного запуска.
exclude_adminboolean
Пропускать администраторов (по умолчанию: True).
filter_role_idinteger | null
Добавляет всем пользователям, у которых есть эта роль. Игнорируется, если задан user_ids.
role_idintegerобязательный
ID роли для добавления.
user_idsinteger[] | null
Явный список идентификаторов пользователей. Если None, используется filter_role_id.

superset_bulk_user_role_remove

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

Параметры

confirmboolean
True применяет изменения. False используется для пробного запуска.
exclude_adminboolean
Пропускать администраторов (по умолчанию: True).
role_idintegerобязательный
ID роли для удаления.
user_idsinteger[] | null
Явный список ID пользователей. Если None, удаляет у ВСЕХ пользователей, у которых оно есть.

superset_bulk_user_role_replace

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

Параметры

confirmboolean
True применяет изменения. False используется для пробного запуска.
exclude_adminboolean
Пропускать администраторов (по умолчанию: True).
new_role_idintegerобязательный
Идентификатор роли, который нужно установить вместо текущего.
old_role_idintegerобязательный
Получает и запрашивает актуальную документацию и примеры кода из Context7 для любой программной библиотеки или фреймворка. Сначала необходимо вызвать инструмент 'Resolve Context7 Library ID', чтобы получить точный идентификатор библиотеки, совместимый с Context7 и необходимый для использования этого инструмента, ЗА ИСКЛЮЧЕНИЕМ случаев, когда пользователь явно указывает идентификатор библиотеки в формате '/org/project' или '/org/project/version' в своём запросе. Не вызывайте этот инструмент более 3 раз для одного вопроса.

superset_chart_cache_warmup

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

Параметры

chart_idintegerобязательный
ID диаграммы для прогрева.
dashboard_idinteger | null
ID дашборда для контекста фильтра (необязательно).

superset_chart_copy

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

Параметры

chart_idintegerобязательный
ID исходного графика для копирования.
dashboardsinteger[] | null
Список идентификаторов дашбордов, к которым нужно привязать копию (необязательно).
slice_namestringобязательный
Не совсем понятно, о чём именно речь: вы хотите перевести фразу «Name for the new copy» на русский, или вам нужно придумать название для нового текста/документа/копии? Если перевод, то варианты: - «Название для новой копии» - «Имя для нового экземпляра» - «Заголовок для нового текста» Если вы просите придумать название — уточните, для чего именно: для документации, статьи, рекламного текста, описания инструмента? Без контекста сложно предложить удачный вариант.

superset_chart_create

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

Параметры

dashboardsinteger[] | null
Список идентификаторов панелей, к которым нужно привязать график.
datasource_idintegerобязательный
Идентификатор набора данных (из superset_dataset_list).
datasource_typestring
Тип источника данных (по умолчанию "table" — набор данных).
paramsstring | null
JSON-строка с параметрами визуализации (зависят от viz_type). Определяет метрики, группировки, фильтры, цвета, подписи и т.д. ВАЖНО — числовые и временные форматы: НЕ используйте SMART_NUMBER или SMART_DATE — они сокращают числа (1.61k вместо 1610) и показывают буквальный текст вместо дат. Используйте явные форматы: - y_axis_format: "d" (целые числа без разделителей), ",d" (с запятыми), ",.2f" (десятичные) - number_format: ",d" (для круговой диаграммы) - x_axis_time_format: "%b %Y" (даты на оси X), "%Y-%m-%d" (ISO) - tooltipTimeFormat: "%Y-%m-%d" или "%Y-%m" (даты во всплывающих подсказках) - show_value: true (показывать числа на столбцах гистограммы) КРИТИЧЕСКИ ВАЖНО — формат даты в Superset 6.x: Superset 6.x использует ТОЛЬКО формат времени D3 (синтаксис strftime). НЕ используйте формат moment.js (YYYY-MM-DD) — он будет отображаться как буквальный текст "YYYY-MM-DD" вместо реальной даты! Правильные форматы (D3/strftime): - "%Y-%m-%d" -> 2026-03-05 (дата ISO) - "%Y-%m-%d %H:%M" -> 2026-03-05 14:30 (дата и время) - "%d.%m.%Y" -> 05.03.2026 (европейский формат) - "%b %Y" -> Mar 2026 (месяц и год) - "%Y" -> 2026 (только год) - "%Y-%m" -> 2026-03 (год и месяц) НЕПРАВИЛЬНЫЕ форматы (moment.js — НЕ РАБОТАЮТ): - "YYYY-MM-DD" — отображается буквально "YYYY-MM-DD" - "DD.MM.YYYY" — отображается буквально "DD.MM.YYYY" - "MMM YYYY" — отображается буквально "MMM YYYY" Параметры, принимающие форматы дат: - table_timestamp_format (таблицы) - x_axis_time_format (ось X) - tooltipTimeFormat (всплывающие подсказки) - y_axis_format (для big_number_total с датой в метрике) big_number_total (KPI-карточки) — СПРАВОЧНЫЕ параметры: - header_font_size: 0.27 (размер числа, ~53px в контейнере 60px) - subheader_font_size: 0.15 (размер подзаголовка) - y_axis_format: "d" (целые числа без разделителей) ВАЖНО — прокрутка в KPI: контейнер big_number_total имеет фиксированную высоту (обычно 60px при 2 ячейках сетки). Слишком большой шрифт вызывает прокрутку. Виновники: font-size + line-height (1.1x) +…
query_contextstring | null
JSON-строка с контекстом запроса. Необходима для работы chart_get_data. Обычно генерируется интерфейсом.
slice_namestringобязательный
Название диаграммы (отображается в интерфейсе).
viz_typestringобязательный
Тип визуализации (Superset 6.x). Основные типы: ECharts (рекомендуется): - echarts_timeseries_bar — столбчатая/горизонтальная столбчатая диаграмма - echarts_timeseries_line — линейная диаграмма - echarts_timeseries_smooth — сглаженная линия - echarts_timeseries_step — ступенчатая линия - echarts_timeseries_scatter — точечная диаграмма - echarts_area — диаграмма с областями - mixed_timeseries — несколько рядов с 2 осями Y - pie — круговая диаграмма - funnel — воронкообразная диаграмма - gauge_chart — шкала/спидометр - radar — лепестковая диаграмма - graph_chart — граф/сеть - tree_chart — дерево - treemap_v2 — древовидная карта - sunburst_v2 — солнечная диаграмма - sankey_v2 — диаграмма Сэнки - heatmap_v2 — тепловая карта - histogram_v2 — гистограмма - box_plot — ящик с усами - bubble_v2 — пузырьковая диаграмма - waterfall — каскадная диаграмма - gantt_chart — диаграмма Ганта KPI: - big_number_total — большое число (KPI) - big_number — большое число с трендом Таблицы: - table — таблица - pivot_table_v2 — сводная таблица Карты: - country_map — карта страны (коды ISO 3166-2) - world_map — карта мира Другое: - word_cloud — облако слов - handlebars — пользовательский шаблон УСТАРЕВШЕЕ (НЕ ИСПОЛЬЗУЙТЕ — ошибка "not registered"): 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.

Параметры

query_contextstringобязательный
JSON-строка с контекстом запроса. Формат: { "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" } ВАЖНО: time_range задаётся на уровне QUERY, а не внутри extras. Допустимые значения time_range: "Last day", "Last week", "Last month", "Last year", "No filter" или "2024-01-01 : 2024-12-31".

superset_chart_delete

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

Параметры

chart_idintegerобязательный
ID графика для удаления.
confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).

superset_chart_export

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

Параметры

chart_idsstringобязательный
ID графиков, разделенные запятыми (например, "1,2,3").

superset_chart_get

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

Параметры

chart_idintegerобязательный
Chart ID (целое число из результата chart_list).

superset_chart_get_data

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

Параметры

chart_idintegerобязательный
Идентификатор диаграммы.

superset_chart_import

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

Параметры

file_pathstringобязательный
Абсолютный путь к ZIP-файлу на диске.
overwriteboolean
Перезаписывает существующие объекты с тем же UUID (по умолчанию False).

superset_chart_list

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

Параметры

get_allboolean
Получает ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
Фильтр RISON для поиска. Примеры: - По имени: (filters:!((col:slice_name,opr:ct,value:search_term))) - По типу: (filters:!((col:viz_type,opr:eq,value:table))) - По набору данных: (filters:!((col:datasource_id,opr:eq,value:1)))

superset_chart_update

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

Параметры

chart_idintegerобязательный
ID диаграммы, которую нужно обновить.
confirm_params_replaceboolean
Подтверждение замены параметров (ОБЯЗАТЕЛЬНО при передаче параметров).
dashboardsinteger[] | null
Новый список ID дашбордов (ЗАМЕНЯЕТ все привязки).
paramsstring | null
Новые JSON-параметры визуализации (полностью заменяют). Смотрите chart_create для справки по числовым и временным форматам. ВАЖНО: params заменяет ВСЕ параметры - сначала получите текущие через chart_get, измените нужные поля и передайте полный JSON. КРИТИЧЕСКИ ВАЖНО: для дат используйте формат D3 strftime ("%Y-%m-%d"), а НЕ moment.js ("YYYY-MM-DD") - иначе будет показан литерал!
query_contextstring | null
Новый JSON-контекст запроса (полностью заменяет предыдущий). ВАЖНО: при изменении params также обновляйте query_context, иначе график будет использовать старый query_context.
slice_namestring | null
Новое имя
viz_typestring | null
Новый тип визуализации (см. chart_create для списка типов).

superset_dashboard_charts

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

Параметры

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

superset_dashboard_copy

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

Параметры

dashboard_idintegerобязательный
ID исходной панели мониторинга для копирования.
dashboard_titlestringобязательный
Заголовок для нового текста.
json_metadatastring | null
JSON-метаданные для копии. ВАЖНО: Superset требует это поле. Если не указано, будет использовано "{}".

superset_dashboard_create

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

Параметры

cssstring | null
Пользовательский CSS для стилизации дашборда.
dashboard_titlestringобязательный
Заголовок дашборда (отображается в интерфейсе).
json_metadatastring | null
JSON-строка с метаданными дашборда. Содержит настройки фильтров, цветовую палитру, интервал обновления. Используйте "{}" для пустых метаданных.
position_jsonstring | null
JSON-строка с позиционированием виджетов на дашборде. Определяет расположение графиков, заголовков, разделителей в сетке.
publishedboolean
Публиковать немедленно (по умолчанию False — черновик).
rolesinteger[] | null
Список идентификаторов ролей, которые могут получить доступ к панели управления. Пользователи, у которых нет ни одной из этих ролей, НЕ увидят панель управления. Пустой список = доступно для всех.
slugstring | null
URL-слаг для красивой ссылки (например, "my-dashboard"). Должен быть уникальным.

superset_dashboard_datasets

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

Параметры

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

superset_dashboard_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
dashboard_idintegerобязательный
ID дашборда для удаления.

superset_dashboard_embedded_delete

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

Параметры

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

superset_dashboard_embedded_get

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

Параметры

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

superset_dashboard_embedded_set

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

Параметры

allowed_domainsstring[] | null
Список доменов, где разрешено встраивание (например, ["example.com", "app.example.com"]). Пустой список = все домены.
dashboard_idintegerобязательный
Идентификатор панели управления.

superset_dashboard_export

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

Параметры

dashboard_idsstringобязательный
Идентификаторы дашбордов через запятую (например, "1,2,3").

superset_dashboard_filter_add

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

Параметры

cascade_parent_idstring | null
ID родительского фильтра для каскадирования.
columnstringобязательный
Название столбца набора данных для фильтрации (например, "full_name").
dashboard_idintegerобязательный
Идентификатор панели управления.
dataset_idintegerобязательный
ID набора данных, предоставляющего значения фильтра.
enable_empty_filterboolean
Пустой фильтр означает фильтрацию по NULL.
filter_typestring
Тип фильтра: "filter_select", "filter_time", "filter_range".
multi_selectboolean
Разрешить множественный выбор (по умолчанию включено).
namestringобязательный
Отображаемое имя фильтра (например, «Полное имя»).
search_all_optionsboolean
Выполняет поиск по всем значениям, а не только по загруженным (для больших списков).

superset_dashboard_filter_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
dashboard_idintegerобязательный
Идентификатор панели управления.
filter_idstringобязательный
ID фильтра для удаления (формат "NATIVE_FILTER-<uuid>").

superset_dashboard_filter_list

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

Параметры

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

superset_dashboard_filter_reset

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

Параметры

confirm_resetboolean
Подтверждение сброса фильтра (ОБЯЗАТЕЛЬНО). { "name": "Полное имя", "column": "full_name", "type": "filter_select", // filter_select | filter_time | filter_range "multi_select": true, // необязательный, по умолчанию true "search_all_options": false, // необязательный, по умолчанию false "enable_empty_filter": false, // необязательный, по умолчанию false "cascade_parent_id": null // необязательный, идентификатор родительского фильтра }
dashboard_idintegerобязательный
Идентификатор панели управления.
dataset_idintegerобязательный
Идентификатор набора данных для всех фильтров.
filters_jsonstringобязательный
JSON-массив определений фильтров. Каждый элемент:

superset_dashboard_filter_update

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

Параметры

cascade_parent_idstring | null
Родительский фильтр ID (Нет - убрать каскадирование).
columnstring | null
Новый столбец для фильтрации.
dashboard_idintegerобязательный
Идентификатор панели управления.
enable_empty_filterboolean | null
Пустой фильтр равен NULL.
filter_idstringобязательный
ID фильтра (формат "NATIVE_FILTER-<uuid>").
multi_selectboolean | null
Множественный выбор.
namestring | null
Новое имя фильтра.
search_all_optionsboolean | null
Ищите все значения.

superset_dashboard_get

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

Параметры

dashboard_idintegerобязательный
ID дашборда (целое число из результата dashboard_list).

superset_dashboard_grant_role_access

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

Параметры

confirm_grantboolean
True: применить изменения. False: только пробный запуск (dry-run).
dashboard_idintegerобязательный
Dashboard ID (из dashboard_list).
role_idintegerобязательный
Идентификатор роли, которой предоставляется доступ (из role_list).

superset_dashboard_import

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

Параметры

file_pathstringобязательный
Абсолютный путь к ZIP-файлу на диске.
overwriteboolean
Перезаписывает существующие объекты с тем же UUID (по умолчанию False).

superset_dashboard_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
Фильтр RISON для поиска. Примеры: - По названию: (filters:!((col:dashboard_title,opr:ct,value:search))) - По владельцу: (filters:!((col:owners,opr:rel_m_m,value:1))) - Только опубликованные: (filters:!((col:published,opr:eq,value:!t)))

superset_dashboard_publish

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

Параметры

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

superset_dashboard_revoke_role_access

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

Параметры

confirm_revokeboolean
True для применения. False только для пробного запуска.
dashboard_idintegerобязательный
Dashboard ID (из dashboard_list).
role_idintegerобязательный
Идентификатор роли, у которой нужно отозвать доступ (из role_list).

superset_dashboard_unpublish

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

Параметры

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

superset_dashboard_update

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

Параметры

cssstring | null
Новый пользовательский CSS для дашборда. Внедряется как тег <style> на странице дашборда. НЕ влияет на представление Explore (редактор графиков) — только на дашборд. Частые исправления CSS: 1) KPI big_number_total — размер цифр и прокрутка: Контейнер KPI имеет фиксированную высоту (~60px при 2 ячейках). Шрифт по умолчанию маленький. Чтобы увеличить через CSS: div[class*="big_number"] .header-line { font-size: 3.3rem !important; /* цифры / font-weight: 700 !important; line-height: 1.1 !important; margin-bottom: 0 !important; / ОБЯЗАТЕЛЬНО! иначе будет прокрутка / } div[class="big_number"] .subheader-line { font-size: 1rem !important; /* подпись */ font-weight: 400 !important; opacity: 0.7; } ВАЖНО: margin-bottom у .header-line по умолчанию равен 8px — вместе с line-height это вызывает переполнение и прокрутку. Формула проверки: font_size_px * 1.1 + margin_bottom <= 60px. 3.3rem = 52.8px -> 52.8 * 1.1 = 58px + 0 = 58px < 60px ОК 2) Подсказка карты Country Map обрезается контейнером — виноват DIV.dashboard-chart (styled-component с overflow:hidden). Подсказка = DIV.hover-popup (НЕ .datamaps-hoverover!). Исправление: .dashboard-chart-id-{N} .dashboard-chart { overflow: visible !important; } .hover-popup { z-index: 99999 !important; } Чтобы проанализировать проблемы с CSS: откройте дашборд в Playwright, найдите элемент графика, поднимитесь по parentElement, проверьте getComputedStyle(el).overflow на каждом уровне.
dashboard_idintegerобязательный
ID панели управления для обновления.
dashboard_titlestring | null
Новый заголовок.
json_metadatastring | object | null
Метаданные JSON дашборда (строка или объект, полностью заменяется).
ownersinteger[] | null
Список идентификаторов (ID) владельцев (ЗАМЕНЯЕТ всех текущих владельцев).
position_jsonstring | object | null
Размещение виджетов на панели управления (строка или объект). Определяет расположение графиков, заголовков, разделителей в сетке. ВАЖНО: полностью заменено — сначала получите текущую раскладку через dashboard_get, измените нужные элементы и передайте весь JSON.
publishedboolean | null
Изменяет статус публикации (true - опубликовано, false - черновик).
rolesinteger[] | null
Список ID ролей для доступа к дашборду (ЗАМЕНЯЕТ текущие). При изменении списка datasource_access автоматически синхронизируется.
slugstring | null
Новый URL slug (должен быть уникальным).

superset_database_available_engines

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

Параметры

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

superset_database_catalogs

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.

superset_database_connection_info

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.

superset_database_create

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

Параметры

allow_ctasboolean
Разрешает CREATE TABLE AS SELECT.
allow_cvasboolean
Разрешить CREATE VIEW AS SELECT.
allow_dmlboolean
Разрешает INSERT/UPDATE/DELETE.
allow_run_asyncboolean
Разрешить асинхронное выполнение запросов.
database_namestringобязательный
Читаемое человеком имя подключения.
expose_in_sqllabboolean
Показывать ли в SQL Lab (по умолчанию Истина).
extrastring | null
JSON-строка с дополнительными настройками (engine_params, metadata_params).
sqlalchemy_uristringобязательный
Строка URI подключения SQLAlchemy. Примеры: - PostgreSQL: postgresql://user:pass@host:5432/dbname - MySQL: mysql://user:pass@host:3306/dbname - SQLite: sqlite:///path/to/db.sqlite

superset_database_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
database_idintegerобязательный
ID подключения для удаления.

superset_database_export

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

Параметры

database_idsstringобязательный
Идентификаторы соединений через запятую (например, "1,2").

superset_database_function_names

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.

superset_database_get

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

Параметры

database_idintegerобязательный
Идентификатор подключения (целое число из результата database_list).

superset_database_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По названию: (filters:!((col:database_name,opr:ct,value:postgres))) - По типу: (filters:!((col:backend,opr:eq,value:postgresql)))

superset_database_related_objects

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.

superset_database_schemas

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

Параметры

database_idintegerобязательный
ID подключения к базе данных (из database_list).

superset_database_select_star

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.
schema_namestring | null
Схема (например, "public"). Если не указано, используется схема по умолчанию.
table_namestringобязательный
Пожалуйста, укажите полный текст, который нужно перевести. Вы отправили только «Table name», но нет контекста для перевода.

superset_database_table_metadata

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.
schema_namestring | null
Схема (например, "public"). Если не указано, используется схема по умолчанию.
table_namestringобязательный
Пожалуйста, укажите полный текст, который нужно перевести. Вы отправили только «Table name», но нет контекста для перевода.

superset_database_tables

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

Параметры

database_idintegerобязательный
ID подключения к базе данных (из database_list).
schema_namestringобязательный
Имя схемы (из database_schemas). Примеры: "public", "source". Передаётся в формате RISON без кавычек.

superset_database_test_connection

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

Параметры

database_namestringобязательный
Имя подключения (отображается в сообщениях об ошибках).
extrastring | null
JSON-строка с дополнительными настройками.
sqlalchemy_uristringобязательный
SQLAlchemy URI для тестирования.

superset_database_update

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

Параметры

allow_ctasboolean | null
Разрешает CREATE TABLE AS SELECT.
allow_cvasboolean | null
Разрешить CREATE VIEW AS SELECT.
allow_dmlboolean | null
Разрешает INSERT/UPDATE/DELETE.
confirm_uri_changeboolean
Подтверждение изменения URI (ОБЯЗАТЕЛЬНО при изменении sqlalchemy_uri).
database_idintegerобязательный
ID подключения для обновления.
database_namestring | null
Новое имя подключения.
expose_in_sqllabboolean | null
Показывать ли в SQL Lab.
extrastring | null
JSON-строка с дополнительными настройками.
sqlalchemy_uristring | null
Новый URI SQLAlchemy. КРИТИЧЕСКИ ВАЖНО: изменение URI ломает все наборы данных и диаграммы, использующие это подключение.

superset_database_validate_parameters

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

Параметры

configuration_methodstring
Метод конфигурации: "sqlalchemy_form" (по умолчанию) или "dynamic_form".
enginestringобязательный
Тип движка базы данных: "postgresql", "mysql", "sqlite", "mssql" и т.д.
parametersobjectобязательный
Словарь параметров подключения: {"host": "...", "port": 5432, "database": "...", "username": "...", "password": "..."}

superset_database_validate_sql

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.
schemastring | null
Схема для контекста валидации (например, «public»).
sqlstringобязательный
SQL-запрос для проверки.

superset_dataset_create

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

Параметры

databaseintegerобязательный
Идентификатор подключения к базе данных (из superset_database_list).
schema_namestring | null
Схема базы данных (например, "public", "source"). Если не указано, используется схема по умолчанию для базы данных.
sqlstring | null
SQL-запрос для виртуального набора данных. Если указан, создает виртуальный набор данных на основе этого запроса.
table_namestringобязательный
Имя таблицы/представления (для физического) или имя набора данных (для виртуального).

superset_dataset_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
dataset_idintegerобязательный
ID набора данных, который нужно удалить.

superset_dataset_duplicate

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

Параметры

base_model_idintegerобязательный
ID исходного набора данных для копирования. ВАЖНО: поле называется base_model_id, а НЕ base_id или dataset_id.
table_namestringобязательный
Название для нового набора данных (должно быть уникальным).

superset_dataset_export

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

Параметры

dataset_idsstringобязательный
ID наборов данных через запятую (например, "1,2,3").

superset_dataset_get

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

Параметры

dataset_idintegerобязательный
Идентификатор набора данных (целое число из результата dataset_list).

superset_dataset_get_or_create

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных (из superset_database_list).
schema_namestring | null
Схема базы данных (например, "public", "source"). Если не указано, используется схема по умолчанию для базы данных.
table_namestringобязательный
Имя таблицы в базе данных.

superset_dataset_import

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

Параметры

file_pathstringобязательный
Абсолютный путь к ZIP-файлу на диске.
overwriteboolean
Перезаписывает существующие объекты с совпадающими UUID (по умолчанию False).

superset_dataset_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По имени: (filters:!((col:table_name,opr:ct,value:search_term))) - По схеме: (filters:!((col:schema,opr:eq,value:public))) - По базе данных: (filters:!((col:database,opr:rel_o_m,value:1)))

superset_dataset_refresh_schema

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

Параметры

dataset_idintegerобязательный
Идентификатор набора данных.

superset_dataset_related_objects

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

Параметры

dataset_idintegerобязательный
Идентификатор набора данных.

superset_dataset_update

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

Параметры

always_filter_main_dttmboolean | null
Принудительно включает или выключает основной фильтр по времени датасета. Superset сбрасывает этот флаг в false при любом PUT-запросе, где он опущен, что ломает временные фильтры дашборда при обновлении только колонок или метрик. Передайте явное значение, чтобы задать его; оставьте None, и текущее значение автоматически сохранится при замене колонок.
columnsstring | null
Строка JSON, описывающая столбцы. КРИТИЧЕСКИ ВАЖНО: передача столбцов ЗАМЕНЯЕТ ВСЕ столбцы набора данных! Чтобы обновить один столбец (например, verbose_name), передайте ВСЕ столбцы с их идентификаторами. После ошибки dataset_refresh_schema восстановит столбцы из SQL. Формат: [{"id": 123, "column_name": "id", "type": "INTEGER", ...}]
confirm_columns_replaceboolean
Подтверждение замены ВСЕХ столбцов (ОБЯЗАТЕЛЬНО при передаче столбцов).
dataset_idintegerобязательный
Идентификатор набора данных для обновления.
descriptionstring | null
Описание датасета (отображается в интерфейсе Superset).
metricsstring | null
JSON-строка, описывающая метрики. Формат: [{"metric_name": "count", "expression": "COUNT(*)", "metric_type": "count"}]
sqlstring | null
Новый SQL-запрос (только для виртуальных наборов данных).
table_namestring | null
Название новой таблицы/набора данных

superset_get_base_url

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

Параметры

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

superset_get_current_user

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

Параметры

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

superset_get_current_user_roles

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

Параметры

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

superset_get_menu

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

Параметры

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

superset_group_add_roles

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

Параметры

group_idintegerобязательный
ID группы.
role_idsinteger[]обязательный
Список ID ролей для добавления.

superset_group_add_users

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

Параметры

group_idintegerобязательный
ID группы.
user_idsinteger[]обязательный
Список ID пользователей для добавления.

superset_group_create

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

Параметры

descriptionstring | null
Описание группы.
labelstring | null
Отображаемая подпись (например, «Московская область»).
namestringобязательный
Уникальное имя группы (например, "la_region_Moscow").
rolesinteger[] | null
Список идентификаторов ролей для назначения группе.
usersinteger[] | null
Список идентификаторов пользователей для добавления в группу.

superset_group_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
group_idintegerобязательный
ID группы для удаления.

superset_group_get

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

Параметры

group_idintegerобязательный
Идентификатор группы (из group_list).

superset_group_list

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

Параметры

get_allboolean
Получите ВСЕ записи с автоматической пагинацией.
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
Фильтр RISON для поиска. Примеры: - По имени: (filters:!((col:name,opr:ct,value:moscow)))

superset_group_remove_roles

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

Параметры

group_idintegerобязательный
ID группы.
role_idsinteger[]обязательный
Список идентификаторов ролей для удаления.

superset_group_remove_users

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

Параметры

group_idintegerобязательный
ID группы.
user_idsinteger[]обязательный
Список ID пользователей для удаления из группы.

superset_group_update

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

Параметры

confirm_roles_replaceboolean
Подтверждение замены роли (обязательно, когда заданы роли).
confirm_users_replaceboolean
Подтверждение замены пользователя (ОБЯЗАТЕЛЬНО, когда задан users).
descriptionstring | null
Новое описание
group_idintegerобязательный
ID группы, которую нужно обновить.
labelstring | null
Новая метка.
namestring | null
Новое имя группы.
rolesinteger[] | null
The user's message contains only an instruction to replace role IDs, but no actual list was provided. I should ask for the specific role IDs they want me to use.
usersinteger[] | null
Новый ПОЛНЫЙ список ID пользователей (ЗАМЕНЯЕТ все текущие).

superset_log_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
Фильтр RISON для поиска. Примеры: - По пользователю: (filters:!((col:user,opr:rel_o_m,value:1))) - По действию: (filters:!((col:action,opr:ct,value:explore)))

superset_permission_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на страницу (по умолчанию 100).
qstring | null
Фильтр RISON для поиска.

superset_permissions_audit

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

Параметры

include_adminboolean
Включите пользователей Admin (у них есть доступ ко всему).
pageinteger
Страница результатов (начиная с 0).
page_sizeinteger
Пользователей на странице (максимум 50).
username_filterstring | null
Фильтровать по имени пользователя (совпадение по подстроке).

superset_query_get

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

Параметры

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

superset_query_list

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

Параметры

get_allboolean
Получает ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По статусу: (filters:!((col:status,opr:eq,value:success))) - По базе данных: (filters:!((col:database,opr:rel_o_m,value:1)))

superset_query_stop

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

Параметры

query_idstringобязательный
Запросить client_id для остановки (строка из результата sqllab_execute).

superset_recent_activity

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).

superset_report_create

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

Параметры

activeboolean
Активен ли (по умолчанию True).
chartinteger | null
Chart ID для скриншота (для Report).
crontabstringобязательный
Расписание Cron. Примеры: - "0 9 * * *" — каждый день в 9:00 - "0 9 * * 1" — каждый понедельник в 9:00 - "0 */6 * * *" — каждые 6 часов
dashboardinteger | null
Идентификатор панели мониторинга для снимка экрана (для отчёта).
databaseinteger | null
Идентификатор подключения к базе данных (для оповещения — условие SQL).
namestringобязательный
Название отчета/оповещения.
recipientsstring | null
JSON-строка со списком получателей. Формат: [{"type": "Email", "recipient_config_json": {"target": "user@example.com"}}]
report_typestring
Тип: «Отчет» (периодическая доставка, по умолчанию) или «Оповещение» (на основе условий).
sqlstring | null
SQL-запрос для проверки условия (для оповещения). Оповещение срабатывает, когда запрос возвращает непустой результат.

superset_report_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
report_idintegerобязательный
ID отчёта для удаления.

superset_report_get

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

Параметры

report_idintegerобязательный
ID отчёта (целое число из результата report_list).

superset_report_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
Фильтр RISON для поиска. Примеры: - По имени: (filters:!((col:name,opr:ct,value:search_term))) - По типу: (filters:!((col:type,opr:eq,value:Report))) - Только активные: (filters:!((col:active,opr:eq,value:!t)))

superset_report_update

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

Параметры

activeboolean | null
Включает/отключает отчет.
crontabstring | null
Новое расписание cron (например, "0 9 * * *").
namestring | null
Новое имя
recipientsstring | null
JSON-строка с новым списком получателей (ЗАМЕНЯЕТ всех текущих получателей).
report_idintegerобязательный
ID отчета для обновления.

superset_rls_create

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

Параметры

clausestringобязательный
Условие SQL WHERE без ключевого слова WHERE. Примеры: - "region = 'Moscow'" - "user_id = {{ current_user_id() }}" - "status IN ('active', 'pending')"
descriptionstring | null
Получает и запрашивает актуальную документацию и примеры кода из Context7 для любой программной библиотеки или фреймворка. Сначала необходимо вызвать инструмент 'Resolve Context7 Library ID', чтобы получить точный идентификатор библиотеки, совместимый с Context7 и необходимый для использования этого инструмента, ЗА ИСКЛЮЧЕНИЕМ случаев, когда пользователь явно указывает идентификатор библиотеки в формате '/org/project' или '/org/project/version' в своём запросе. Не вызывайте этот инструмент более 3 раз для одного вопроса.
filter_typestring
Тип фильтра: - "Regular" (по умолчанию) — дополнительное ограничение для указанных ролей - "Base" — базовый фильтр, применяемый ко всем пользователям
group_keystring | null
Ключ группировки правил (необязательно).
namestringобязательный
Название правила
rolesinteger[]обязательный
Список идентификаторов ролей, на которые распространяется правило (из role_list).
tablesinteger[]обязательный
Список ID наборов данных, на которые распространяется правило (из dataset_list).

superset_rls_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
rls_idintegerобязательный
ID правила RLS для удаления.

superset_rls_get

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

Параметры

rls_idintegerобязательный
Идентификатор правила RLS (из rls_list).

superset_rls_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
Фильтр RISON для поиска.

superset_rls_update

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

Параметры

clausestring | null
Новое условие SQL WHERE (без ключевого слова WHERE).
descriptionstring | null
Новое описание
filter_typestring | null
Новый тип: "Regular" или "Base".
group_keystring | null
Новый ключ группировки.
namestring | null
Новое имя
rls_idintegerобязательный
ID правила RLS для обновления.
rolesinteger[] | null
Список ID ролей (ЗАМЕНЯЕТ все текущие). ОБЯЗАТЕЛЬНО, если указан tables.
tablesinteger[] | null
Список ID наборов данных (ЗАМЕНЯЕТ все текущие). ОБЯЗАТЕЛЬНО, если указано roles.

superset_role_copy_permissions

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

Параметры

confirmboolean
True применяет изменения. False используется для пробного запуска.
source_role_idintegerобязательный
Роль, из которой копируются разрешения.
target_role_idintegerобязательный
Роль, в которую копируются разрешения (существующие разрешения будут ЗАМЕНЕНЫ).

superset_role_create

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

Параметры

namestringобязательный
Название роли (должно быть уникальным).

superset_role_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
role_idintegerобязательный
ID роли, которую нужно удалить.

superset_role_get

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

Параметры

role_idintegerобязательный
Role ID (целое число из результата role_list).

superset_role_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По имени: (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
Подтверждение полной замены разрешений (ОБЯЗАТЕЛЬНО).
permission_view_menu_idsinteger[]обязательный
Полный список идентификаторов разрешений для роли. Идентификаторы разрешений можно получить через superset_permission_list.
role_idintegerобязательный
Идентификатор роли

superset_role_permissions_get

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

Параметры

role_idintegerобязательный
Идентификатор роли

superset_role_update

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

Параметры

namestringобязательный
Новое имя роли.
role_idintegerобязательный
ID роли, которую нужно переименовать.

superset_saved_query_create

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

Параметры

db_idintegerобязательный
Идентификатор подключения к базе данных (из superset_database_list).
descriptionstring | null
Описание запроса.
labelstringобязательный
Название запроса (отображается в списке).
schemastring | null
Схема по умолчанию (например, "public").
sqlstringобязательный
SQL-запрос, чтобы сохранить.

superset_saved_query_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
saved_query_idintegerобязательный
Сохранённый ID запроса для удаления.

superset_saved_query_get

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

Параметры

saved_query_idintegerобязательный
Сохранённый идентификатор запроса (из saved_query_list).

superset_saved_query_list

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

Параметры

get_allboolean
Получает ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По метке: (filters:!((col:label,opr:ct,value:search_term))) - По базе данных: (filters:!((col:database,opr:rel_o_m,value:1)))

superset_saved_query_update

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

Параметры

descriptionstring | null
Новое описание
labelstring | null
Новое имя
saved_query_idintegerобязательный
Сохраненный ID запроса.
schemastring | null
Новая схема по умолчанию.
sqlstring | null
Новый SQL-запрос.

superset_sqllab_estimate_cost

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

Параметры

database_idintegerобязательный
Идентификатор подключения к базе данных.
schemastring | null
Схема для контекста (например, "public").
sqlstringобязательный
SQL-запрос для оценки.

superset_sqllab_execute

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

Параметры

catalogstring | null
Каталог базы данных (для баз данных с поддержкой каталога, необязательно).
database_idintegerобязательный
Идентификатор подключения к базе данных (из superset_database_list).
schemastring | null
Схема по умолчанию для запроса (например, "public", "source"). Если она не указана, используется схема базы данных по умолчанию.
sqlstringобязательный
SQL-запрос для выполнения. Примеры: - SELECT * FROM public.my_table LIMIT 10 - SELECT count(*) FROM source.stat
tab_namestring | null
Название вкладки в интерфейсе SQL Lab (необязательно, для организации).
template_paramsstring | null
JSON-строка с параметрами шаблона Jinja (необязательно). Пример: '{"start_date": "2024-01-01"}'

superset_sqllab_export_csv

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

Параметры

client_idstringобязательный
Запрашивает client_id (из результата superset_sqllab_execute).

superset_sqllab_format_sql

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

Параметры

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

superset_sqllab_results

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

Параметры

results_keystringобязательный
Ключ результатов из ответа superset_sqllab_execute.

superset_tag_bulk_create

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

Параметры

tagsstringобязательный
JSON-строка со списком тегов. Формат: [ {"name": "production", "objects_to_tag": [["dashboard", 1], ["chart", 5]]}, {"name": "analytics", "objects_to_tag": [["dataset", 3]]} ] objects_to_tag: пары [object_type, object_id]. Допустимые типы: "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.

Параметры

descriptionstring | null
Описание тега (необязательно).
namestringобязательный
Имя тега.
objects_to_tagstring | null
Строка JSON со списком объектов для тегирования. Формат: [["dashboard", 1], ["chart", 5], ["dataset", 3], ["saved_query", 2]] Каждый элемент — пара [object_type, object_id]. Допустимые типы: "dashboard", "chart", "dataset", "saved_query".

superset_tag_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
tag_idintegerобязательный
Идентификатор тега для удаления.

superset_tag_get

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

Параметры

tag_idintegerобязательный
Tag ID (целое число из результата tag_list).

superset_tag_get_objects

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
tagsstring | null
Имена тегов через запятую (например, "analytics,production"). Если не указано, возвращает все тегированные объекты.

superset_tag_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По имени: (filters:!((col:name,opr:ct,value:search_term)))

superset_tag_update

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

Параметры

descriptionstring | null
Новое описание (необязательно).
namestringобязательный
Имя тега (ОБЯЗАТЕЛЬНО, даже если не изменилось).
tag_idintegerобязательный
ID тега для обновления.

superset_user_create

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

Параметры

activeboolean
Указывает, активна ли учетная запись (по умолчанию True).
emailstringобязательный
Адрес электронной почты (должен быть уникальным).
first_namestringобязательный
Имя пользователя.
last_namestringобязательный
Фамилия пользователя.
passwordstringобязательный
Пароль
rolesinteger[] | null
Список идентификаторов ролей для назначения (из superset_role_list). Если не указано, будет назначена роль по умолчанию (Public).
usernamestringобязательный
Логин (должен быть уникальным).

superset_user_delete

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

Параметры

confirm_deleteboolean
Подтверждение удаления (ОБЯЗАТЕЛЬНО).
user_idintegerобязательный
ID пользователя, которого нужно удалить.

superset_user_get

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

Параметры

user_idintegerобязательный
User ID (целое число из результата user_list).

superset_user_list

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

Параметры

get_allboolean
Получить ВСЕ записи с автоматической пагинацией (игнорирует page/page_size).
pageinteger
Номер страницы (начиная с 0).
page_sizeinteger
Количество записей на странице (максимум 100).
qstring | null
RISON-фильтр для поиска. Примеры: - По имени пользователя: (filters:!((col:username,opr:ct,value:admin))) - Только активные: (filters:!((col:active,opr:eq,value:!t))) - По роли: (filters:!((col:roles,opr:rel_m_m,value:1)))

superset_user_update

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

Параметры

activeboolean | null
Активировать/деактивировать учетную запись.
confirm_roles_replaceboolean
Подтверждение замены роли (ОБЯЗАТЕЛЬНО при передаче ролей).
emailstring | null
Новый email (должен быть уникальным).
first_namestring | null
Новое имя.
last_namestring | null
Новая фамилия.
rolesinteger[] | null
Новый список идентификаторов ролей (ЗАМЕНЯЕТ все текущие роли).
user_idintegerобязательный
ID пользователя для обновления.

`0.3.1`основная	25.07.2026
`0.3.0`	25.07.2026
`0.2.8`	13.07.2026
`0.2.7`	15.06.2026
`0.2.6`	09.06.2026
`0.2.5`	05.04.2026
`0.2.4`	11.03.2026
`0.2.3`	11.03.2026
`0.2.2`	11.03.2026
`0.2.1`	11.03.2026
`0.2.0`	11.03.2026
`0.1.0`	10.03.2026

Выберите клиент, чтобы установить bintocher/mcp-superset:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"bintocher-mcp-superset-v2teohvc9d\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-superset\",\"--transport\",\"stdio\"],\"env\":{\"SUPERSET_BASE_URL\":\"https://superset.example.com\",\"SUPERSET_USERNAME\":\"admin\",\"SUPERSET_PASSWORD\":\"your_password\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add bintocher-mcp-superset-v2teohvc9d --env SUPERSET_BASE_URL=https://superset.example.com --env SUPERSET_USERNAME=admin --env SUPERSET_PASSWORD=your_password -- uvx mcp-superset --transport stdio

Либо через JSON-конфиг:

claude mcp add-json bintocher-mcp-superset-v2teohvc9d "{\"command\":\"uvx\",\"args\":[\"mcp-superset\",\"--transport\",\"stdio\"],\"env\":{\"SUPERSET_BASE_URL\":\"https://superset.example.com\",\"SUPERSET_USERNAME\":\"admin\",\"SUPERSET_PASSWORD\":\"your_password\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add bintocher-mcp-superset-v2teohvc9d --env SUPERSET_BASE_URL=https://superset.example.com --env SUPERSET_USERNAME=admin --env SUPERSET_PASSWORD=your_password -- uvx mcp-superset --transport stdio

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.bintocher-mcp-superset-v2teohvc9d]
command = "uvx"
args = ["mcp-superset", "--transport", "stdio"]

[mcp_servers.bintocher-mcp-superset-v2teohvc9d.env]
SUPERSET_BASE_URL = "https://superset.example.com"
SUPERSET_USERNAME = "admin"
SUPERSET_PASSWORD = "your_password"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите bintocher/mcp-superset, а в поле команды запуска — строку ниже:

uvx mcp-superset --transport stdio

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например bintocher-mcp-superset-v2teohvc9d.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: bintocher-mcp-superset-v2teohvc9d
    command: uvx
    args:
      - "mcp-superset"
      - "--transport"
      - "stdio"
    env:
      SUPERSET_BASE_URL: https://superset.example.com
      SUPERSET_USERNAME: admin
      SUPERSET_PASSWORD: your_password

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "bintocher-mcp-superset-v2teohvc9d": {
      "command": "uvx",
      "args": [
        "mcp-superset",
        "--transport",
        "stdio"
      ],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "mcp-superset",
    "--transport",
    "stdio"
  ],
  "env": {
    "SUPERSET_BASE_URL": "https://superset.example.com",
    "SUPERSET_USERNAME": "admin",
    "SUPERSET_PASSWORD": "your_password"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx