Apache Superset MCP: дашборды и SQL Lab в Claude, Codex и Cursor

bintocher/mcp-superset· Проверено 12.11.2026· 66на GitHub

Подключает агента к вашему Apache Superset: дашборды, графики, датасеты, SQL Lab и права доступа. Агент находит данные, пишет запросы и собирает графики через REST API Superset.

3 реализации:

137 инструментов на весь REST API, включая нативные фильтры, пользователей, роли, RLS и аудит прав; удаление и замена прав требуют флагов подтверждения, SQL Lab пропускает только чтение.

Как подключить

Что сделать до подключения

Python 3.12 или новее и uv с командой uvx

Пользователь Superset с ролью Admin для полного доступа к API

SUPERSET_BASE_URL

адрес вашего Superset, например https://superset.example.com

SUPERSET_USERNAME

логин пользователя Superset; SUPERSET_AUTH_PROVIDER=ldap для входа через LDAP

SUPERSET_PASSWORD

пароль этого пользователя

SUPERSET_SESSION_COOKIE

для Superset за SSO: значение cookie session из инструментов разработчика браузера вместо логина и пароля

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SUPERSET_BASE_URL=<адрес Superset>' --env 'SUPERSET_USERNAME=<логин>' --env 'SUPERSET_PASSWORD=<пароль>' --transport stdio superset \
  -- uvx mcp-superset --transport stdio

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

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

[mcp_servers.superset.env]
SUPERSET_BASE_URL = "<адрес Superset>"
SUPERSET_USERNAME = "<логин>"
SUPERSET_PASSWORD = "<пароль>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "superset": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "superset": {
        "type": "local",
        "command": ["uvx", "mcp-superset", "--transport", "stdio"],
        "environment": {
          "SUPERSET_BASE_URL": "<адрес Superset>",
          "SUPERSET_USERNAME": "<логин>",
          "SUPERSET_PASSWORD": "<пароль>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

superset_dashboard_listищет дашборды

superset_dashboard_getчитает дашборд

superset_dashboard_createсоздаёт дашборд

superset_dashboard_chartsвыводит графики дашборда

superset_dashboard_filter_addдобавляет нативный фильтр

superset_chart_listищет графики

superset_chart_createсоздаёт график

superset_chart_dataполучает данные графика

superset_database_listвыводит подключения к базам

superset_database_tablesвыводит таблицы схемы

superset_database_table_metadataчитает столбцы и индексы

superset_dataset_createсоздаёт датасет из таблицы или SQL

superset_dataset_refresh_schemaобновляет столбцы из источника

superset_sqllab_executeвыполняет SELECT в SQL Lab

superset_sqllab_export_csvвыгружает результат в CSV

superset_saved_query_createсохраняет запрос

superset_user_listищет пользователей

superset_dashboard_grant_role_accessдаёт роли доступ к дашборду

superset_permissions_auditстроит матрицу прав

superset_assets_exportвыгружает все объекты в ZIP

Показано 20 из 137.

Пакет npm с упором на датасеты: метрики и вычисляемые столбцы, параметры и фильтры графиков, размещение графиков на дашборде; можно войти по токену доступа.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Доступ к экземпляру Apache Superset: логин и пароль или токен доступа

SUPERSET_BASE_URL

адрес вашего Superset

SUPERSET_USERNAME

логин Superset

SUPERSET_PASSWORD

пароль Superset

SUPERSET_ACCESS_TOKEN

вместо логина и пароля: токен доступа Superset

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SUPERSET_BASE_URL=<адрес Superset>' --env 'SUPERSET_USERNAME=<логин>' --env 'SUPERSET_PASSWORD=<пароль>' --transport stdio superset-mcp \
  -- npx -y superset-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.superset-mcp]
command = "npx"
args = ["-y", "superset-mcp"]

[mcp_servers.superset-mcp.env]
SUPERSET_BASE_URL = "<адрес Superset>"
SUPERSET_USERNAME = "<логин>"
SUPERSET_PASSWORD = "<пароль>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "superset-mcp": {
      "command": "npx",
      "args": ["-y", "superset-mcp"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "superset-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "superset-mcp"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "superset-mcp": {
      "command": "npx",
      "args": ["-y", "superset-mcp"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "superset-mcp": {
      "command": "npx",
      "args": ["-y", "superset-mcp"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "superset-mcp": {
        "type": "local",
        "command": ["npx", "-y", "superset-mcp"],
        "environment": {
          "SUPERSET_BASE_URL": "<адрес Superset>",
          "SUPERSET_USERNAME": "<логин>",
          "SUPERSET_PASSWORD": "<пароль>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "superset-mcp": {
      "command": "npx",
      "args": ["-y", "superset-mcp"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "superset-mcp": {
      "command": "npx",
      "args": ["-y", "superset-mcp"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Инструменты сервера

list_datasetsищет датасеты

create_datasetсоздаёт датасет

find_and_replace_in_sqlменяет текст в SQL датасета

create_dataset_metricсоздаёт метрику

create_calculated_columnсоздаёт вычисляемый столбец

list_chartsищет графики

create_chartсоздаёт график

get_chart_paramsотдаёт схему параметров графика

update_chartменяет график

set_chart_filtersзадаёт фильтры графика

list_dashboardsищет дашборды

get_dashboard_chart_query_contextраскрывает запрос графика на дашборде

add_chart_to_dashboardставит график на дашборд

execute_sqlвыполняет SQL

list_databasesвыводит подключения к базам

Показано 15 из 32.

Ранний сервер на Python с 60 инструментами: дашборды, графики, базы, SQL Lab, теги и ссылки на исследование; токен хранит в файле .superset_token в папке проекта.

Как подключить

Что сделать до подключения

Склонировать репозиторий и выполнить uv pip install .

Для Claude Desktop можно прописать сервер командой mcp install main.py

SUPERSET_BASE_URL

адрес Superset, по умолчанию http://localhost:8088

SUPERSET_USERNAME

логин Superset

SUPERSET_PASSWORD

пароль Superset

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SUPERSET_BASE_URL=<адрес Superset>' --env 'SUPERSET_USERNAME=<логин>' --env 'SUPERSET_PASSWORD=<пароль>' --transport stdio superset-mcp \
  -- python /path/to/superset-mcp/main.py

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.superset-mcp]
command = "python"
args = ["/path/to/superset-mcp/main.py"]

[mcp_servers.superset-mcp.env]
SUPERSET_BASE_URL = "<адрес Superset>"
SUPERSET_USERNAME = "<логин>"
SUPERSET_PASSWORD = "<пароль>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "superset-mcp": {
      "command": "python",
      "args": ["/path/to/superset-mcp/main.py"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "superset-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["/path/to/superset-mcp/main.py"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "superset-mcp": {
      "command": "python",
      "args": ["/path/to/superset-mcp/main.py"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "superset-mcp": {
      "command": "python",
      "args": ["/path/to/superset-mcp/main.py"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "superset-mcp": {
        "type": "local",
        "command": ["python", "/path/to/superset-mcp/main.py"],
        "environment": {
          "SUPERSET_BASE_URL": "<адрес Superset>",
          "SUPERSET_USERNAME": "<логин>",
          "SUPERSET_PASSWORD": "<пароль>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "superset-mcp": {
      "command": "python",
      "args": ["/path/to/superset-mcp/main.py"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "superset-mcp": {
      "command": "python",
      "args": ["/path/to/superset-mcp/main.py"],
      "env": {
        "SUPERSET_BASE_URL": "<адрес Superset>",
        "SUPERSET_USERNAME": "<логин>",
        "SUPERSET_PASSWORD": "<пароль>"
      }
    }
  }
}

Инструменты сервера

superset_dashboard_listвыводит дашборды

superset_chart_createсоздаёт график

superset_database_get_tablesвыводит таблицы базы

superset_database_validate_sqlпроверяет SQL

superset_dataset_createсоздаёт датасет

superset_sqllab_execute_queryвыполняет SQL-запрос

superset_sqllab_format_sqlформатирует SQL

superset_sqllab_estimate_query_costоценивает стоимость запроса

superset_tag_object_addвешает тег на объект

superset_explore_permalink_createсоздаёт ссылку на исследование

Показано 10 из 60.

Что попросить агента

«Покажи первые 10 датасетов, сначала недавно изменённые; только id и table_name»Winding2020/superset-mcp вызовет list_datasets с сортировкой и выбором полей

«Создай табличный график «Sample Table» по датасету 12»Агент получит схему через get_chart_params и создаст график create_chart

«Сделай график 42 столбчатым с группировкой по стране и SUM(value)»Агент вызовет update_chart

«Выполни на базе 1: SELECT * FROM users LIMIT 10»mcp-superset вызовет superset_sqllab_execute, aptro — superset_sqllab_execute_query

«Дай роли <роль> доступ к дашборду <id> и покажи, какие датасеты откроются»mcp-superset вызовет superset_dashboard_grant_role_access: сначала пробный прогон, затем confirm_grant=True

Для каких задач

Найти дашборд или график и показать, на каких датасетах он построен

Выполнить запрос в SQL Lab и выгрузить результат в CSV

Создать датасет из таблицы и собрать по нему график

Добавить в датасет метрику или вычисляемый столбец

Повесить нативный фильтр на дашборд

Выдать роли доступ к дашборду вместе с датасетами и проверить матрицу прав

Ограничения

mcp-superset проверен на Superset 6.0.1, aptro/superset-mcp — на 4.1.1; для полного доступа к API mcp-superset нужна роль Admin

SQL Lab в mcp-superset пропускает только чтение: DROP, DELETE, UPDATE, INSERT, ALTER и другие команды изменения блокируются

Вход по cookie для SSO сервер не продлевает: когда сессия истекла, вставьте новое значение и перезапустите сервер

aptro/superset-mcp не обновлялся с июля 2025 года; у Winding2020/superset-mcp 24 звезды и не указана лицензия

Если не работает

С cookie сессии Superset отвечает 401 {"msg": "Missing Authorization Header"}

REST API этого экземпляра принимает только JWT: свежий cookie не поможет, входите по логину и паролю.

Сервер не видит cookie сессии

Имя cookie не всегда session: если в superset_config.py задан SESSION_COOKIE_NAME, возьмите имя из инструментов разработчика и укажите его в SUPERSET_SESSION_COOKIE_NAME.

aptro/superset-mcp не может авторизоваться

Проверьте логин и пароль в .env, доступность Superset по SUPERSET_BASE_URL и версию: сервер проверен на Superset 4.1.1.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-superset	Stanislav Chernov (bintocher)	66	локально	токен	137	10 ноября 2026
Superset MCP Server	Winding2020	24	локально	токен	32	30 сентября 2026
Superset MCP Integration	aptro	195	локально	токен	60	28 июля 2025

Частые вопросы

Какой сервер Superset выбрать?

mcp-superset шире всех: 137 инструментов, управление пользователями, ролями и RLS, защита от случайного удаления. Winding2020/superset-mcp удобен для работы с метриками и вычисляемыми столбцами датасетов. aptro/superset-mcp давно не обновлялся.

Как подключить Superset, если вход через SSO?

Вход по паролю через REST API за SSO недоступен. Скопируйте cookie session в инструментах разработчика браузера и передайте в SUPERSET_SESSION_COOKIE; если cookie называется иначе, задайте имя в SUPERSET_SESSION_COOKIE_NAME.

Агент может случайно удалить дашборд?

В mcp-superset удаление дашборда, графика, датасета или базы требует confirm_delete=True и показывает, что затронется. Системные роли Admin, Alpha, Gamma и Public удалить нельзя.

Можно подключить mcp-superset по HTTP?

Да, по умолчанию сервер поднимает streamable HTTP на 127.0.0.1:8001. Запустите uvx mcp-superset и укажите в клиенте адрес http://localhost:8001/mcp.

Почему агент часто заново входит в Superset?

JWT в Superset по умолчанию живёт 15 минут. mcp-superset обновляет токен сам, а в superset_config.py можно поднять JWT_ACCESS_TOKEN_EXPIRES, например до часа.

Что умеет Apache Superset MCP?

Через него агент работает с вашим Apache Superset: ищет дашборды и графики, создаёт датасеты, выполняет запросы в SQL Lab. mcp-superset ещё управляет пользователями, ролями, RLS и нативными фильтрами.

Как подключить Superset MCP к Claude Code?

Для mcp-superset запустите uvx mcp-superset и добавьте в .mcp.json проекта сервер с type http и url http://localhost:8001/mcp. Вариант через stdio с переменными SUPERSET_* есть во вкладке Claude Code в блоке «Как подключить».

Работает ли сервер из России?

Серверы запускаются у вас и обращаются только к вашему экземпляру Superset по его адресу, зарубежные аккаунты не нужны.

Apache Superset MCP: дашборды и SQL Lab в Claude, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы